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Preface 



VAX/VMS Release Notes, Version 4.6 describes Version 4.6 of the VAX/VMS 
operating system. It lists and discusses changes to the system, new features, 
corrected problems, and restrictions in its use. It also describes changes and 
corrections to the VAX/VMS documentation set. Part II of the VAX/VMS 
Release Notes, Version 4.6 contains the LAT/VMS Management Guide. This 
guide provides complete documentation of the new LAT/VMS software. 



Intended Audience 

This book contains information of interest to general users, system managers, 
application programmers, and system programmers. 



Structure of This Document 

This book has two parts. Part I contains the following chapters: 

• Chapter 1: Upgrading to VAX/VMS Version 4.6 (guidelines for 
performing the Version 4.6 upgrade) 

• Chapter 2: New and Changed Features 

• Chapter 3: Problems, Restrictions, and Notes 

Part II contains the LAT/VMS Management Guide. This guide describes and 
explains the tasks involved in managing the Local Area Transport (LAT) 
software on Version 4.6 systems. It includes the following chapters and 
appendices: 

• Chapter 4: Functions of LAT/VMS Software on a VMS System 

• Chapter 5: VAX/ VMS Service Node Management 

• Chapter 6: Setting Up Remote Printers 

• Chapter 7: LAT Port Driver QIO Interface 

• Chapter 8: LATCP Command Descriptions 

• Appendix A: ASCII Characters for Node and Service Names 

• Appendix B: Qualifiers for DCL Printer Setup Commands 

• Appendix C: LATCP Error Messages 
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Associated Documents 



The following documents provide information that is relevant to Version 4.6 
and the Version 4.6 upgrade procedure: 

VAX/VMS Release Notes, Version 4.5 

VAX/VMS System Manager's Reference Manual 

Guide to VAX/VMS Software Installation 

Guide to VAXclusters 

VAX/VMS Operating System, Version 4.6 Software Product Description. 
SPD 25.01.29 

The System Software Ordering Table (SPD 28.98.xx) 



Conventions Used In This Document 



The following conventions are observed in this manual: 



Convention 



Meaning 



RET 



$ SHOW TIME 
11-NOV-1987 11:55:22 



$ TYPE MYFILE.DAT 



file-spec, . . . 
[logical-name] 



quotation marks ( " ) 
apostrophe (') 



A symbol with a one- to six-character 
abbreviation indicates that you press a key 
on the terminal, for example, RET. 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

Vertical series of periods, or ellipsis, means 
either that not all the data that the system 
would display in response to the particular 
command is shown or that not all the data a 
user would enter is shown. 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be 
entered. 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

The term quotation marks is used to refer 
to double quotation marks {"). The term 
apostrophe ( ' ) is used to refer to a single 
quotation mark. 
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Part I VAX/ VMS Release Notes, Version 4.6 

Part I contains release notes for VAX/ VMS Version 4.6. It includes 
instructions for upgrading to Version 4.6, descriptions of new and 
changed features, and a summary of problems, restrictions, and 
notes. 



1 Upgrading to VAX/ VMS Version 4.6 



1.1 Introduction 



This chapter describes the VAX/VMS Version 4.6 upgrade procedure. 
To perform the upgrade procedure successfully, you should have an 
understanding of the basic operations of the system that you are upgrading. 

If you are a new customer, install Version 4.6 by following the instructions 
provided in your processor's installation guide. 

This chapter covers the following topics: 

• Precautions for the upgrade 

• Preparations for the upgrade 

• Performing an upgrade on a system 

• Performing an upgrade on a VAXcluster 

• Performing post-upgrade procedures 

• References to associated manuals 

Chapter 1 is divided into the following sections: 

• Section 1.1 — Introduction 

• Section 1.2 — Upgrade Considerations 

• Section 1.3— Upgrading a Single System 

• Section 1.4— Upgrading VAXcluster Systems 

Before you begin the upgrade procedure, read Section 1.2, Upgrade 
Considerations. DIGITAL recommends that you read the entire chapter 
before you begin the upgrade. 

After reading Section 1.2, turn to the section that pertains to your particular 
configuration, and follow the numbered steps. 



1 .2 Upgrade Considerations 

This section discusses pre-upgrade considerations. 
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1.2.1 Cautions and Restrictions 

You must observe the following cautions and restrictions for this upgrade: 

• Your system must be running Version 4.4 or Version 4.5 in order to 
install the Version 4.6 upgrade. If your system is not currently running 
VAX/VMS Version 4.4 or 4.5, you must upgrade to at least VAX/VMS 
Version 4.4 before you begin the Version 4.6 upgrade procedure. 

• If current system directories have been altered in any way, the upgrade 
procedure may not work correctly. You must restore your operating 
system to a standard system before performing the upgrade. 

• The upgrade cannot be applied to a tailored system. A tailored system 
must be installed on a separate, initialized disk. 

• The Version 4.6 upgrade procedure does not support RC25 and RK07 
system disks. However, you can install Version 4.6 on RC25 and RK07 
system disks. 

• You must not move the system disk and the distribution volume from 
one device to another during the upgrade. 



1 .2.2 Layered Products Caution 



Because of the way the upgrade procedure is designed, you should not 
have to reinstall most layered products after the upgrade. However, certain 
layered products must be reinstalled because of product-specific installation 
procedures. For example, products that create directories synonymous with 
system directories must be reinstalled. 

In addition, some layered products recommend reinstallation after an upgrade. 
To find out if DIGITAL recommends reinstallation of your layered product 
consult the product installation guide. 

You must reinstall VAX PSI and VAX PSI Access, SPD number 25.40.xx. 
You must reinstall the following software keys: 

• Multiprocessing (VAX 8300 and 8800) 

• Volume Shadowing 

• DECnet 

• Local Area VAXclusters 

• VAX ENCRYPTION 



1 .2.3 General Notes 



The following factors should be noted before performing the upgrade: 

• If the upgrade is interrupted for any reason, you can resume from the 
point at which the system was most recently booted. The upgrade 
reboots the system several times during the upgrade procedure. 

• The upgrade procedure purges the paging, swapping, dump, and 
authorization files. 

• The upgrade procedure deletes everything in the [SYSERR] directory. 
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The upgrade procedure deletes all operator and accounting logs. To save 
these files, move them to a user directory before starting the upgrade. 



1 .2.4 Suggestions 



The following list contains suggestions to help you perform the upgrade: 

• DIGITAL recommends backing up the system disk before performing 
the upgrade. If your system is a VAX 8600 or 8650, DIGITAL also 
recommends backing up the console RL02. 

• A major part of the upgrade is automated and does not require the 
presence of an operator throughout the procedure. Therefore, you should 
perform the upgrade from a hard-copy device to record all returned data. 
Note, however, that if you are upgrading a VAX 8500/8550 or VAX 
8700/8800, you must perform the upgrade from the console (PRO 380). 

• Consider having a second terminal logged in for doing support tasks 
during the upgrade. 



1 .2.5 Materials Needed 

The VAX/VMS Version 4.6 Upgrade requires the following materials: 

• A Version 4.6 software distribution kit 

• A blank disk for building the upgraded system 

• A blank console volume of the following type: 

• RXOl floppy diskette for VAX-1 1/780, VAX-1 1/782, or VAX-1 1/785 

• RL02 for VAX 8600 and VAX 8650 

• RX50 floppy diskette for VAX 8200 and VAX 8300 

• TU58 cartridge for VAX-11/725, VAX-11/730, and VAX-11/750 
processors 

Note: You do not need a blank console volume to upgrade a VAX 8500, 8550, 
8700, or 8800. 

DIGITAL provides Local Area VAXcluster customers with media containing 
the Local Area VAXcluster software key. This key is on one of the following 
media types: 

• Magnetic tape 

• TK50 

• RA60 
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1 .3 Upgrading a Single System 



This section explains how to upgrade a single VAX/VMS system. It is 
divided into four major sections: 

• System Upgrade Summary 

• Pre-upgrade Procedure 
" Upgrade Procedure 

• Post-upgrade Procedure 



1.3.1 System Upgrade Summary 



upgrades are performed on existing operating systems to bring them up to the 
latest major revision from the most recent maintenance version. For example, 
if you want to bring a Version 4.5 system up to Version 4.6, you perform the 
Version 4.6 upgrade. For the upgrade to be successful, the current system files 
must be substantially the same as they were when the system was installed. 

A system upgrade consists of the following nine steps: 

1 Back up your current system disk to the disk that will be used for the 
upgrade. 

2 Boot the new system volume and log into the system manager's account 
(SYSTEM). 

3 If you want to keep any files that may be affected by the upgrade, move 
them to a user directory. 

4 Be sure you have enough space on the new system volume to do the 
upgrade. 

5 Be sure the CPU is set up for automatic restart. 

6 Prevent users from logging into the system, stop all queues, and, if 
applicable, shut down the network. 

7 Invoke the VMSINSTAL command procedure and follow instructions 
displayed through the five upgrade phases. 

8 If any of the system reboots fail, change system parameters as directed. 

9 When the upgrade is completed, boot the new system and make 
any required changes in system procedures before resuming normal 
operations. 



1 .3.2 Pre-Upgrade Procedure 



This section explains how to prepare the system for the upgrade procedure. 
Perform the operations in this section before you begin the upgrade 
procedure. When you have finished this section, go on to the next section. 
The pre-upgrade procedure is divided into numbered tasks. Each task consists 
of several steps. Follow the steps in the indicated order. 

Perform the following pre-upgrade steps. This section describes each step in 
detail. 

1 Back up the system disk. 
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2 Boot the backup system disk. 

3 Check free blocks. 

4 Check and set page file size. 

5 Shut down the network. 

6 Stop queues. 

7 Set SYSGEN parameters. 

8 Set the RESTART switch. 

9 Reboot the system (if SYSGEN parameters or page file size were 
modified). 

1 Configure system devices. 

1 1 Isolate the system from users. 

1 2 Modify DEFBOO.COM and dddGEN.COM (if upgrading a VAX 8500, 
8550, 8700, or 8800). 

Note: If you are using volume shadowed system disks, you must perform 

specific pre-upgrade procedures and post-upgrade procedures in order to 
successfully upgrade to Version 4.6. These procedures are described in 
detail in Section 4.4 of the VAX /VMS Volume Shadowing Manual. 

Use the following procedure to prepare for the upgrade: 

1 BACKING UP THE SYSTEM DISK 

To ensure successful upgrade completion, DIGITAL recommends that 
you back up the system disk. When you back up the system disk, you 
accomplish the following: 

• Preserve the original system disk. 

• Improve disk performance by making free space on the new system 
disk contiguous. 

To back up the system disk, proceed as follows: 

a Use standalone BACKUP to back up the current system disk. A step- 
by-step procedure for backing up the system is given in the Guide to 
VAX/VMS Software Installation. 

b Perform one of the following options, depending upon your system's 
configuration: 

• If an extra disk drive with a disk of equal capacity is available, 
you can perform a disk-to-disk backup directly from the original 
system disk. You can then save the original system disk and use 
the new backup system disk for the upgrade. 

To use the new backup disk for the upgrade, you must swap the 
unit address plugs from the disk drive with the original system 
disk to the disk drive with the new backup disk. You must do 
this so that you will be able to boot from the new backup disk. 

• If an extra disk drive of equal capacity is not available, you can 
do a backup from the original system disk to whatever other 
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type of device is available. In this case, you must subsequently 
perform either of the following options: 

• If the original system disk can be removed, remove the 
disk and replace it with a scratch disk. Then, reverse the 
backup process by doing a backup from your backup device 
to the scratch disk. The scratch disk is now your new backup 
system disk. After you have finished, save the original system 
disk and use the new backup system disk for the upgrade. 

• If the original system disk cannot be removed, you must use 
it for the upgrade. However, even though you are using the 
original system disk for the upgrade, you must still perform 
a backup operation from the backup device to the original 
system disk. After you have finished, save the backup media 
and use the original system disk for the upgrade. 

Note: If you have a VAX 8600 or 8650, back up the console media at this 
, point. Use the command procedure SYS$UPDATE:CONSCOPY 
to create an RL02 backup copy of the console media. Refer to the 
VAX/VMS System Manager's Reference Manual for further information 
about backing up the console media. 

2 BOOTING THE BACKUP SYSTEM DISK 

Booting is performed in console mode. The system indicates it is in 
console mode by displaying a > > > prompt on the console terminal. 
Upon completion of the boot, the console program automatically returns 
the system to program mode. If you have any problems booting the 
system, refer to the Guide to VAX/VMS Software Installation. 

Boot the backup copy of the system disk (or the restored system disk, if 
you could not remove it) by performing the following steps: 

a Put the system into console mode by pressing CTRL/P. 

b Halt the processor by entering HALT and pressing RETURN. 

c Invoke the default boot procedure by entering the following 
command at the console terminal keyboard: 

>» B 

3 CHECKING FREE BLOCKS 

You must have 27,000 free blocks on the system disk you are upgrading. 
Use the following procedure to check disk space and, if necessary, create 
free blocks: 

a Log in under the system manager account, SYSTEM, after the new 
system disk is booted. 

b Confirm the free block count by entering the following command at 
the DCL level: 

$ SHOW DEVICE SYS$SYSDEVICE 

c If necessary, create free blocks by deleting or purging files until the 
minimum of 27,000 is reached. 
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4 CHECKING AND SETTING PAGE FILE SIZE 

You must have 4600 blocks in the system page file. Check and modify 
the page file size on your system using the following procedure: 

a Confirm the number of blocks in the system page file by entering the 
following command at the DCL level: 

$ fflSYS$UPDATE:SWAPFILES 

The SWAPFILES procedure displays current file sizes and prompts 
you to enter new values: 

Enter new size for paging file: 

b Perform one of the following steps: 

• Press RETURN to retain the current page file value if it is greater 
than 4600 blocks. 

• Enter 4600 to increase the page file to 4600 blocks. 

c To keep the default values, press RETURN in response to the 
following prompts: 

Enter new size for system dump file: 
Enter new size for swapping file: 

5 SHUTTING DOWN THE NETWORK 

Perform the following task only if running DECnet-VAX: 

a Remain logged in under the system manager account, SYSTEM. 

b Shut down the network as follows: 

$ RUN SYS$SYSTEM:NCP 

NCP> SET EXECUTOR STATE OFF 

c Press CTRL/Z to return to DCL command level. 

6 STOPPING QUEUES 

Stop all batch and print queues. 

a Determine the state of a queue as follows: 

$ SHOW QUEUE/DEVICE/BATCH/FULL/ALL 
b Skip the next step if no queues are active. 
c Use the following DCL command to stop all active queues: 

$ STOP/QUEUE/MANAGER 

7 SETTING SYSGEN PARAMETERS 

Before beginning the upgrade procedure, the SYSGEN parameters 
SCSNODE, ALLOCLASS, STARTUP_P1, SCSSYSTEMID, and 
VAXCLUSTER must be set to the following values: 

VAXCLUSTER must be 

ALLOCLASS must be 

SCSNODE must be blank 

STARTUP_P1 must be "MIN" 

SCSSYSTEMID must be an unused number 
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Parameter Name 
VAXCLUSTER 



Check and set the values of these parameters as follows: 
a Invoke SYSGEN: 

$ RUN SYS$SYSTEM: SYSGEN 
b Set for "current": 

SYSGEII> USE CURRENT 
c Show the VAXCLUSTER parameter and set to "0": 
SYSGEN> SHOW VAXCLUSTER 
Current Default Minimum Maximum Unit Dynamic 
110 2 Coded-value 



Parameter Name 
SCSNODE 



SYSGEN> SET VAXCLUSTER 
d Show the SCSNODE parameter and set to "0": 
SYSGEN> SHOW SCSNODE 
Current Default Minimum Maximum Unit Dynamic 
"NODE > • ZZZZ" Ascii 



Parameter Name 
STARTUP_P1 



Parameter Name 
ALLOCLASS 



Parameter Name 
SCSSYSTEMID 



SYSGEN> SET SCSNODE "" 
e Show the STARTUP_P1 parameter and set to "MIN": 
SYSGEN> SHOW STARTUP.Pl 
Current Default Minimum Mstximum Unit Dynamic 

" " "ZZZZ" Ascii 

SYSGEN> SET STARTUP.Pl "MIN" 
f Show the ALLOCLASS parameter and set to "0": 
SYSGEN> SHOW ALLOCLASS 
Current Default Minimum Maximum Unit Dynamic 

10 255 Pure-number 

SYSGEN> SET ALLOCLASS 

g Show the SCSSYSTEMID parameter and set to an unused number 
(such as 1500): 

SYSGEN> SHOW SCSSYSTEMID 

Current Default Minimum Maximum Unit Dynamic 

1027 -1 -1 Pure-number 



SYSGEN> SET SCSSYSTEMID 1500 
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h Save the new parameter settings and exit SYSGEN: 

SYSGEN> WRITE CURRENT 

SYSGEN> EXIT 

8 SETTING THE RESTART SWITCH 

Make sure the restart switch on the processor control panel is set to 
automatic restart. This enables the upgrade to continue automatically. 
Refer to the following chart to determine the proper switch setting for 
your system: 



VAX System 



Restart Switch 



Required Setting 



VAX- 11/725 


AUTO/RESTART BOOT 


ON 


VAX- 11/730 


AUTO/RESTART BOOT 


ON 


VAX- 11/750 


POWER ON ACTION 


(RESTART) 


VAX- 11/780 


AUTO/RESTART 


ON 


VAX- 11/785 


AUTO/RESTART 


ON 


VAX-8600 


RESTART/BOOT 


RESTART/BOOT 


VAX-8200/8300 


AUTO START 


ON 


VAX-8500/8550/8700/8800 


AUTO RESTART 


ENABLED 


VAX-8500/8550/8700/8800 


AUTO BOOT 


ENABLED 



Note: If you are upgrading a VAX 8500, 8550, 8700, or 8800, you enable 

AUTO RESTART and AUTO BOOT by entering commands in console 
mode, not by setting a switch. To enter console mode, press CTRL/P 
at the PRO 380 console. Then enter the following commands: 

>» ENABLE AUTO BOOT 
>» ENABLE AUTO RESTART 

To return to the system level, enter the following command: 

>» SET TERMINAL PROGRAM 

9 REBOOTING THE SYSTEM 

If any of SYSGEN parameters are modified (as described in Step 6) or if 
the page file size was changed (as described in Step 4), you must reboot 
the system before continuing the upgrade procedure. 

a Reboot the system disk as follows: 

$ QSYSSSYSTEM: SHUTDOWN 

b The SHUTDOWN procedure asks you a series of questions about the 
system shutdown. 

• Answer the questions appropriately. 

• Be sure to answer YES when asked if an automatic system boot 
should be performed. 

If you have any problems rebooting the system, or if you want further 
information about system rebooting, refer to the VAX/VMS System 
Manager's Reference Manual. 
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10 CONFIGURING SYSTEM DEVICES 

Once the system is running, reconfigure all available system devices: 
a Invoke SYSGEN: 

t RUN SYS$SYSTEM: SYSGEN 
b Configure the system devices: 

SYSGEN> AUTOCONFIGURE ALL 
c Exit SYSGEN and return to the DCL level: 

SYSGEN> EXIT 
d Run STARTUP CONFIGURE: 

$ aSYS$SYSTEM : STARTUP CONFIGURE 

Note: You must run STARTUP CONFIGURE to enable the system to 
recognize all HSC-based disks and tapes after the reboot. 

1 1 ISOLATING THE SYSTEM FROM USERS 

a Enter the following DCL command to prevent users from logging in 
to the system: 

$ SET LOGINS/INTERACTIVE=0 

12 MODIFYING DEFBOO.COM AND dddGEN.COM 

Note: Perform this step only if you are upgrading a VAX 8500, 8550, 8700, or 
8800. 

Before beginning the upgrade procedure, you must modify the console 
DEFBOO.COM and dddGEN.COM (where ddd specifies the device type) 
to boot the system device from the SYSF root directory. Before making 
these modifications, make copies of DEFBOO.COM and dddGEN.COM 
for future use. 

DEFBOO.COM and dddGEN.COM might be located in the processor- 
specific console directory, [Sxxx], the console directory, [CONSOLE], or 
both. The system searches the processor-specific directory (for example, 
[8800] for a VAX 8800 processor) before searching the console directory. 
Before copying and modifying DEFBOO.COM and dddGEN.COM, check 
the processor specific directory for these procedures. If the processor 
specific directory contains DEFBOO.COM and dddGEN.COM, make 
sure you set default to the processor-spedfic directory before making 
modifications. If DEFBOO.COM and dddGEN.COM do not reside in the 
processor-specific directory, modify the procedures located in the console 
directory. This ensures that the system finds and executes the modified 
procedure. 

Use the following procedure to copy and modify DEFBOO.COM and 
dddGEN.COM: 

a Go to the P/OS DCL level by entering the following commands: 

$ CTRL/P 
»> EXIT 

Your default directory is now [CONSOLE]. If DEFBOO.COM and 
dddGEN.COM are located in the processor-specific directory [8xxx], 
set the default directory to the the processor-specific directory. 
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b From the P/OS DCL level, enter the following commands: 

$ COPY dddGEN.COM dddGEN.SAV 
$ COPY DEFB00.COM DEFBOD.SAV 

These commands create copies dddGEN.SAV and DEFBOO.SAV. 

c Modify DEFBOO.COM and dddGEN.COM to boot from SYSF by 
doing the following: 

1 Copy the boot file for the system device to DEFBOO.COM 

2 Using an editor, modify DEFBOO.COM and dddGEN.COM to 
deposit the hexadecimal value F in R5 at bits <31:28> . To 
access the EDT editor, enter RUN EDT at the P/OS DCL prompt. 
Enter the name of the file to be modified (DEFBOO.COM or 
dddGEN.COM) at the EDT prompt (EDT> ). You must modify 
the line that has the following comment: 

! Software boot control flags and 
root directory # in <31:28>. 

For DEFBOO.COM, change the line to read: 

DEPOSIT R5 FOOOOOOO 

For dddGEN.COM, change the line to read: 

DEPOSIT R5 FOOOOOOl 

For example, if you are booting from a device on the CIBCI, you copy 
BCIBOO.COM to DEFBOO.COM, then edit both DEFBOO.COM and 
BCIGEN.COM. 

d To return to the VMS DCL level, set the default directory back to 
[CONSOLE], then enter the following commands: 

$ RUN CONTROL 

>» SET TERMINAL PROGRAM 



1 .3.3 Performing the Upgrade 

This section explains the upgrade procedure for a single VAX/VMS system. 
It is assumed that you have already completed the pre-upgrade procedure 
described in Section 1.3.2. 

The upgrade procedure is divided into the following segments: 

• Beginning the upgrade procedure 

• Phase 1 

• Phase 2 

• Phase 3 

• Phase 4 

• Phase 5 

You must perform all parts of the upgrade procedure. 
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1 .3.3.1 Beginning the Upgrade Procedure 

During this portion of the upgrade, the VMSINSTAL procedure asks you a 
series of questions by displaying prompts. The following subsections explain 
each of the questions and the proper response. 

You can enter a question mark (?) for help at any time during the execution 
of VMSINSTAL. For additional information about VMSINSTAL, see 
Chapter 5 of the Guide to VAX/VMS Software Installation. 

Perform the following steps to install the upgrade kit. Respond to upgrade 
procedure prompts at the operator's console. 

1 MOUNTING THE DISTRIBUTION VOLUME 

a Place the VAX/VMS Version 4.6 distribution volume on the 
appropriate drive. 

• If you are using a tape drive, thread the tape and put the drive on 
line. Be sure that the tape is write-protected. 

• If you are using a disk drive, spin the disk up. 

2 INVOKING VMSINSTAL 

Begin the update procedure by invoking the VMSINSTAL command 
procedure as follows: 

a Set your default directory to SYS$UPDATE: 

$ SET DEFAULT SYS$UPDATE: 
b Enter the VMSINSTAL command: 

$ aVMSINSTAL 
The following VMSINSTAL message is displayed: 

VMS Software Product Installation Procedure V4.6 

It ia (date) at (tine) . 

Enter a question mark (?) at any time for help. 

3 BACKING UP THE DISK 

The first prompt asks you the following question about disk backup: 
*Are you satisfied with the backup of your system disk [YES]? 

• If you have already backed up the system disk, press RETURN to 
continue the upgrade. 

• If you have not backed up the old system disk, or you are not satisfied 
with the previous backup, perform the steps that follow. If you have 
a VAX 8600 or 8650 and have not backed up the console RL02, you 
should also perform these steps: 



a 



Enter NO. VMSINSTAL returns to the DCL level to perform the 
backup. 

Refer to Section 1.3.2 for instructions on backing up the system 
and console disks. 

When the backup operation is completed, begin the upgrade 
procedure again from the beginning of this section. 



1-12 



Upgrading to VAX/VMS Version 4.6 



4 SPECIFYING THE DEVICE NAME 

VMSINSTAL requests the name of the drive holding the distribution 
volume (load device): 

*Where will the distribution volumes be mounted: 

a Enter the device name. 

• If the distribution volumes are to be mounted on a device other 
than an HSC device, use the format ddcu when you answer this 
prompt. 

For example, if your distribution kit is a magnetic tape, on a 
local drive, on controller A, with unit number 0, you would enter 
MSAO. 

• If the distribution volumes are to be mounted on an HSC device, 
respond to the prompt using the format hsc_name$ddcu, where: 

hsc—name identifies the HSC device. 

dd specifies the type of device (load device). 

c refers to the controller number. 

u refers to the device unit number. 

For example, you might enter the following: 

MUTT$DJA2 

• After you successfully enter the device name (you receive no 
VMSINSTAL error messages), go on to Step 5. 

• If VMSINSTAL returns an error message, try reentering the 
device name. If an error message is returned again, perform the 
next step (Step b). 

b Correct the error and try again. 

VMSINSTAL displays an "invalid device" error message if you enter 
an incorrect device name, a nonexistent device, or a device that is not 
connected. The VMSINSTAL procedure continues to prompt for the 
device name until you enter it correctly. 

• To correct the error, do the following: 

1 Check the device name you are using and make sure you are 
entering the correct name for the device. 

2 Check the status of the device itself to be sure it is properly 
connected and set up. 

3 Go back to Step a (Enter the Device Name) and try again. 

• If you get an error message again, you must do the following: 

1 Enter CTRL/Y. 

2 Use the DCL command SHOW DEVICE to verify device 
name and status. 

3 Begin the upgrade procedure over again from the beginning 
of this section. 
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SPECIFYING THE PRODUCT 

VMSINSTAL prompts for the name of the product to be installed: 

♦Products : 

Enter the following: 

VMS046 

READYING THE DISTRIBUTION VOLUME 

Finally, you are asked if the distribution volume is ready for mounting on 
the selected device: 

*Are you ready? 

This question is asking you if the distribution media has been placed 
on the load device (drive) and is ready to be mounted by the upgrade 
procedure. 

a Prepare the distribution media on the load device (drive). 

b Enter Y when the distribution volume is ready for mounting. 

The following messages are then displayed: 

•/.MOUNT-I-MOUNTED. VMS046 mounted on _ddcu: 

The following products will be processed: 

VMS V4 . 6 

Beginning installation of VMS 4.6 at <date hh:inffl> 
'/.VMSINSTAL- 1 -RESTORE. Restoring product save set A... 

VAX/VMS V4.6 Upgrade Procedure 



7 READING INFORMATIONAL MESSAGES 

The upgrade procedure now begins displaying informational messages 
that do the following: 

• Describe what VMSINSTAL is doing. 

• Offer notes, suggestions, and restrictions about various facets of the 
upgrade. 

• Keep track of the status of the upgrade. 

Read these messages carefully to decide whether or not you need to 
interrupt the upgrade procedure. 

8 INTERRUPTING THE UPGRADE 

The system allows interruption of the upgrade procedure at various 
points. Wait for the prompt that asks you if you want to interrupt: 

Do you want to continue? (Y/N) : 

• Enter YES to begin Phase 1 of the upgrade. 

• Go to the next section. Upgrade Phase 1, for further information. 

• The upgrade procedure now displays a series of questions. 
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Enter NO to interrupt the upgrade. 

• Read and follow the instructions provided by VMSINSTAL. 

• You must invoke VMSINSTAL to resume the upgrade. 

• The configuration of your system determines the point at which 
the upgrade resumes. 



1 .3.3.2 Upgrade Phase 1 

Four separate sets of instructions are provided for Phase 1 procedures. You 
use only one set, depending upon the type of system you are upgrading. 
Determine which instructions to use by finding your system in the following 
list and turning to the appropriate section; 

• Upgrading VAX-11/750 systems— turn to Upgrade Phase lA. 

• Upgrading VAX 8200/8300 systems— turn to Upgrade Phase IB. 

• Upgrading VAX 8500/8550 or VAX 8700/8800 systems— turn to Upgrade 
Phase IC. 

• Upgrading VAX-1 1/725, VAX-1 1/730, VAX-1 1/780, VAX-1 1/782, 
VAX-1 1/785, VAX 8600, and VAX 8650 systems— turn to Upgrade Phase 
ID. 

Upgrade Phase lA — for VAX-11/750 

This section describes the first phase of the upgrade for users who are 
upgrading VAX-11/750 systems. 

1 To ensure system security, the upgrade procedure requires you to change 
the passwords for the SYSTEM, SYSTEST, and FIELD accounts before 
continuing. The system requires passwords of six or more characters. 

2 The upgrade procedure turns off the disk quotas on the system disk and 
removes directory entries that point to nonexistent files. 

You are provided the option of booting from the TU58 rather than 
directly from the disk. If you are using a CI750, answer YES in response 
to the prompt. DIGITAL recommends answering YES in any case to 
ensure that you build a console TU58 with the latest versions of the VMB 
and BOOT58 programs. If you are booting directly from a local system 
disk, skip to Step 4. 

3 The procedure builds the upgraded system in system root SYSF so that 
the current system is available if needed. At this point, the upgrade 
procedure guides you through the building of a new console TU58; 
the procedure changes the default bootstrap command procedure 
(DEFBOO.CMD) on the new console volume to boot from SYSF. 

Position the BOOT DEVICE switch on the processor control panel to 
position A. 

When prompted, insert the old console TU58 in the console drive. 
The procedure uses the old console volume as a base to build the new 
console volume but does not modify the old console volume. The 
procedure copies the old console volume to a scratch disk directory. 

The procedure then prompts you to set DEFBOO.CMD to boot the 
backup copy of the system disk (assuming you have not done so 
previously). Using the form dduBOO.CMD, enter the name of the 
boot file to copy to DEFBOO.CMD. 

1-15 



a 



Upgrading to VAX/VMS Version 4.6 



For example, if the system disk is in DBAl, enter DBlBOO.CMD. If 
the system disk is controlled by either an HSC or a UDA, you must 
use the revised version of CIBOO.CMD or DUABOO.CMD that boots 
the disk you wish to upgrade. The selected command procedure must 
be able to boot the system disk without any operator intervention (for 
example, registers RO through R5 must be correctly initialized by the 
command procedure). 

Do not specify a conversational boot command file. The upgrade kit 
is set with parameters that boot any system. The procedure builds a 
conversational boot file (UPGGEN.CMD) that boots from SYSF. Use 
this file only for the situations prescribed by the procedure. 

d When instructed, remove the old console volume and store it in a safe 
place. When prompted, insert a blank volume in the console drive; 
do not remove it for the rest of the upgrade. 

Note: Be sure the RECORD button on the new console TU58 cassette is 
set to allow writing of the cassette. 

e The procedure now lets you use the Bad Block Locator Utility (BAD) 
to check the new console volume before it is initialized. BAD checks 
the new console volume for any defective blocks. If running BAD, 
allow an additional 30 minutes for this procedure. 

DIGITAL recommends performing the BAD check. For details on 
running BAD, see the ANALYZE/MEDIA command in the VAK/VMS 
DCL Dictionary and the VAX/VMS Bad Block Locator Utility Reference 
Manual. 

4 At this point the upgrade procedure cleans up directories on the system 
disk, removes installed images, initializes the new console volume, and 
displays a series of messages that indicate the state of the upgrade. 

5 Eventually, the upgrade procedure indicates that it will shut down to 
reboot the partially installed Version 4.6 system. The procedure should 
reboot automatically. If necessary, you can reboot manually as follows: 

• If booting from the console TU58, reboot the system from the 
BOOT58 command level. To invoke BOOT58, press CTRL/P to 

put the system in console mode, then enter the following sequence of 
commands: 

>» B/800 DDAO 
B00T58> B 

• If booting from the disk, press CTRL/P to enter console mode and 
reboot with the following command: 

>» B/FOOOOOOO ddcu 

6 If the system fails to boot in a CI750 environment because of insufficient 
nonpaged dynamic memory, use the conversational boot command 
procedure UPGGEN.CMD to increase the NPAGEDYN system parameter; 
otherwise, proceed to Step 7. 

To invoke UPGGEN.CMD when booting from a disk, press CTRL/P to 
get into console mode, then enter the following command: 

>» B/FOOOOOOl ddcu 
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If booting from a TU58, invoke BOOT58 from console mode using the 
following command: 

>» B/800 DDAO 

At the BOOT58 prompt, enter the following command: 

BO0T58> QUPGGEN.CMD 

For either boot method, enter the following commands to SYSGEN: 

SySBOOT> SET NPAGEDYN 120000 
SYSBOOT> CONTINUE 

7 During the shutdown, the following error message will appear: 

XSHUTDOWN-I-STOPQUEMAN, the queue manager will now be stopped. 

7.SYSTEM-F-DEV0FFLINE, device is not in configuration or not available. 

This error message may be ignored during the upgrade procedure. 

When the system reboots, you receive the following message: 

VAX/VMS Version 4.6 <date hh:inm> 

9 This completes Phase 1 of the upgrade. The rest of the upgrade does not 
require the presence of an operator. However, if you boot from the TU58, 
you will have to manually reboot each time the system shuts down (once 
in Phase 4 and once in Phase 5). If booting from the disk, reboots are 
automatic and do not require user intervention. 

1 Go on to Phase 2. 

Upgrade Phase 1 B — for VAX 8200/8300 

This section describes the first phase of the upgrade for users who are 
upgrading VAX 8200/8300 systems. 

1 To ensure system security, the upgrade procedure requires you to change 
the passwords for the SYSTEM, SYSTEST, and FIELD accounts before 
continuing. The system requires passwords of six or more characters. 



8 



2 



The upgrade procedure turns off the disk quotas on the system disk and 
removes directory entries that point to nonexistent files. 

You are provided the option of booting from the RX50 rather than directly 
from the disk. If using a CIBCI, answer YES to this question. If booting 
directly from a local disk, skip to Step 4. 

The procedure builds the upgraded system in system root SYSF so that 
the current system is available if needed. At this point, the upgrade 
procedure guides you through the building of a new console RX50; 
the procedure changes the default bootstrap command procedure 
(DEFBOO.CMD) on the new console volume to boot from SYSF. 

When prompted, insert the old console RX50 in the console drive. 
The procedure uses the old console volume as a base to build the new 
console volume, but does not modify the old console volume. The 
procedure copies the old console volume to a scratch disk directory. 

The procedure then prompts you to set DEFBOO.CMD to boot the 
backup copy of the system disk (assuming you have not done so 
previously). Using the form dduBOO.CMD, enter the name of the 
boot file to copy to DEFBOO.CMD. 
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If the system disk is controlled by an HSC, you must use the revised- 
version of CIBOO.CMD that you built when you first installed 
VAX/VMS. The selected command procedure must be able to boot 
the system disk without any operator intervention (for example, 
registers RO through R5 must be correctly initialized by the command 
procedure). 

Do not specify a conversational boot command file. The upgrade kit 
is set with parameters that boot any system. The procedure builds a 
conversational boot file (UPGGEN.CMD) that boots from SYSF. Use 
this file only for the situations prescribed by the procedure. 

c When instructed, remove the old console volume and store it in a safe 
place. When prompted, insert a blank volume in the console drive; 
do not remove it for the rest of the upgrade. 

d The procedure now lets you use the Bad Block Locator Utility (BAD) 
to check the new console volume before it is initialized. BAD checks 
the new console volume for any defective blocks. If running BAD, 
allow an additional 30 minutes for this procedure. 

DIGITAL recommends performing the BAD check. For details on 
running BAD, see the ANALYZE/MEDIA command in the VAX/VMS 
DCL Dictionary and the VAX/VMS Bad Block Locator Utility Reference 
Manual. 

4 At this point the upgrade procedure initializes the new console volume, 
cleans up directories on the system disk, removes installed images, and 
displays a series of messages indicating the state of the upgrade. 

5 Eventually, the upgrade procedure indicates that it will shut down to 
reboot the partially installed Version 4.6 system. The procedure should 
reboot automatically. If necessary, the upgrade system can be restarted 
manually as follows: 

• If booting from the console RX50, reboot the system from the 
BOOT58 command level. To invoke BOOT58, press CTRL/P to 
put the system in console mode and enter the following sequence of 
commands: 

>» B/R5:800 CSAl 
B00T58> B 

• If booting from the disk, press CTRL/P to enter console mode and 
reboot with the following command: 

>» B/R5 : FOOOOOOO ddnu 

In the command above, the variable n refers to the VAXBI node 
number. 

6 If the system fails to boot in a CIBCl environment because of insufficient 
nonpaged dynamic memory, use the conversational boot command 
procedure UPGGEN.CMD to increase the NPAGEDYN system parameter; 
otherwdse, proceed to Step 7. 

If booting from a disk, press CTRL/P to enter console mode, then enter 
the following command: 

>» B/R5:F0000001 ddnu 

In the above command, the variable n refers to the VAXBI node 
number. 
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If booting from an RX50, invoke BOOTS 8 from console mode using the 
following command: 

»> B/R5:800 CSAl 

At the BOOT58 prompt, enter the following sequence of commands: 

B0OT58> eUPGGEN.CMD 
SySBOOT> SET NPAGEDYN 120000 
SYSBOQT> CONTINUE 

7 During the shutdown, the following error message will appear: 
7.SHUTD0WN-I-STDPQUEMAN, the queue manager will now be stopped. 
7.SYSTEM-F-DEV0FFLINE, device is not in configuration or not available. 
This error message can be ignored during the upgrade procedure. 

8 When the system reboots, you receive the following message: 
VAX/VMS Version 4.6 <date hh:min> 

9 This completes Phase 1 of the upgrade. The rest of the upgrade does 
not require the presence of an operator. Note that if field service has 
set the EEPROM so that the default boot device is set to your current 
system disk, you can set the lower key switch to Autostart. In this case, 
rebooting is automatic and does not require user intervention. 

10 Go on to Phase 2 of the upgrade. 

Upgrade Phase 1 C— for VAX 8500/8550 or VAX 8700/8800 

This section describes the first phase of the upgrade for users who are 
upgrading VAX 8500/8550 or VAX 8700/8800 systems. 

Note: The Version 4.6 upgrade does not supply an updated version of VMB.EXE 
for VAX 8500/8550 or VAX 8700/8800 system; these systems continue to 
use the last version. New versions of VMB.EXE are included as part of a 
console software package that ships separately from VAX/VMS. 

1 To ensure system security, the upgrade procedure requires you to change 
the passwords for the SYSTEM, SYSTEST, and FIELD accounts before 
continuing. The system requires passwords of six or more characters. 

2 The upgrade procedure now turns off the disk quotas on the system disk 
and removes directory entries that point to nonexistent files. 

3 The procedure builds the upgraded system in system root SYSF so that 
the current system is available if needed. 

4 At this point the upgrade procedure cleans up directories on the system 
disk, removes installed images, and displays a series of messages 
indicating the state of the upgrade. 

5 Eventually, the upgrade procedure indicates that it will shut down to 
reboot the partially installed Version 4.6 system. The procedure should 
reboot automatically. If necessary, the upgrade system can be restarted 
manually as follows: 

• Press CTRL/P to enter console mode, then enter the following 
sequence of commands: 

>» H 

>» CLEAR RESTART.FLAGS 
>» B 
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6 If the system fails to boot in a CIBCI environment because of insufficient 
nonpaged dynamic memory, use the conversational boot command 
procedure dddGEN.CMD (where ddd indicates the device type) to 
increase the NPAGEDYN system parameter; otherwise, proceed to Step 7. 

To invoke UPGGEN.CMD, press CTRL/P to enter console mode, then 
enter the following commands: 

>» H 

>» CLEAR RESTART.FLAGS 
>» edddGEN.COM 

At the SYSBOOT prompt, enter the following commands: 

SYSBOOT> SET NPAGEDYN 150000 
SYSBOOT> COKTINUE 

7 During the shutdown, the following error message appears: 
XSHUTDGWN-I-STOPQUEMAN, the queue manager will now be stopped. 
XSYSTEM-F-DEVOFFLINE. device is not in configuration or not available. 
This error message can be ignored during the upgrade procedure. 

8 When the system reboots, you receive the following message: 
VAX/VMS Version 4.6 <date hh:ima> 

9 This completes Phase 1 of the upgrade. The rest of the upgrade does not 
require the presence of an operator until the completion of Phase 4. 

10 Go on to Phase 2 of the upgrade. 

Upgrade Phase 1 D— for VAX-1 1/725, VAX-1 1/730, VAX-1 1/780, 
VAX-1 1/782, VAX-1 1/785, VAX 8650, and VAX 8600 Systems 

1 To ensure system security, the upgrade procedure requires you to change 
the passwords for the SYSTEM, SYSTEST, and FIELD accounts before 
continuing. The system requires passwords of six or more characters. 

2 The upgrade procedure now turns off the disk quotas on the system disk 
and removes directory entries that point to nonexistent files. 

3 The procedure builds the upgraded system in system root SYSF, so that 
the current system is available if needed. At this point the upgrade 
procedure guides you through the building of a new console volume that 
allows booting the new system from SYSF. Specifically, the procedure 
changes the default bootstrap command procedure (DEFBOO.CMD) on 
the new console volume to boot from SYSF. 

Note: If you are upgrading a VAX 8600 or VAX 8650, note that all command 
procedures referenced in the following steps will have .COM file 
types, not .CMD file types. 

4 The procedure prompts you to insert the old console volume in the 
console drive. The procedure uses the old console volume as a base to 
build the new volume, but does not modify the old console volume. The 
procedure copies the old console volume to a scratch disk directory. 
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Note: If you have a VAX 8600 or 8650, the upgrade procedure uses the old 
console RL02 during the upgrade, and does not create a new copy. 
Therefore, you should back up the console RL02 before performing 
the upgrade. 

If the new console volume is a TU58, be sure the RECORD button on 
the cassette is set to allow writing of the TU58. 

5 The procedure then prompts you to set DEFBOO.CMD to boot the backup 
copy of the system disk (assummg you have not done so previously). 
Using the form dduBOO.CMD, enter the name of the boot file to copy to 
DEFBOO.CMD. 

For example, if the system disk is in DBAl, enter DBlBOO.CMD. If the 
system disk is controlled by either an HSC or a UDA, you must use the 
revised version of CIBOO.CMD or DUABOO.CMD that you built when 
you first installed VAX/VMS on the HSC- or the UDA-controUed system 
disk. The selected command procedure must be able to boot the system 
disk without any operator intervention (for example, registers RO through 
R5 must be correctly initialized by the command procedure). 

Do not specify a conversational boot command file. The upgrade kit 
is set with parameters that boot any system. The procedure builds a 
conversational boot file (UPGGEN.CMD) that boots from SYSF. Use this 
file only for situations prescribed by the procedure. 

6 When instructed, remove the old console volume and store it in a safe 
place. When prompted, insert a blank volume in the console drive; do 
not remove this volume for the rest of the upgrade. 

7 The procedure now lets you use the Bad Block Locator Utility (BAD) to 
check the new console volume before it is initialized. BAD checks the 
new console volume for any defective blocks. If you choose to run BAD, 
allow an additional 30 minutes for a TU58 volume and 15 additional 
minutes for a floppy volume. 

DIGITAL recommends performing the BAD check. For details on running 
BAD, see the ANALYZE/MEDIA command in the VAX/VMS DCL 
Dictionary and the VAX/VMS Bad Block Locator Utility Reference Manual. 

Note: The Bad Block Locator Utility is not used for upgrades on the VAX 
8600 or VAX 8650. 

8 The procedure initializes the new console volume and displays messages 
that describe the state of the build. After several messages, the upgrade 
describes the correct method for handling a shutdown or reboot failure. 
Note the following information about these failures: 

• On a VAX-11/730 system, the microcode can be reloaded. If the 
system fails to boot correctly, power the system off and then on 
again, so that the console reloads the microcode from the newly 
created TU58. 
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• If the system fails to boot in a CI780 environment because of 
insufficient nonpaged dynamic memory, use the conversational 
boot command procedure UPGGEN.CMD to increase NPAGEDYN as 
follows: 

>» OUPGGEN.CMD 

SYSBOQT> SET NPAGEDYN 120000 

SYSBO0T> CONTINUE 

When the system reboots, you receive the following message: 

VAX/VMS Version 4.6 <date hh:iiim> 

During the shutdown, the following error message will appear: 
•/.SHUTDOWN-I-ISTOPQUEMAN, the queue manager will now be stopped. 
■/,SYSTEM-F-DEVOFFLINE , device is not in configuration or not available. 

You can ignore this error message during the upgrade procedure. 
9 Proceed to Phase 2 of the upgrade. 



1 .3.3.3 Upgrade Phase 2 

Phase 2 restores the rest of the VAX/VMS Version 4.6 files in the LIBRARY 
and OPTIONAL save sets. This step varies, depending on the system 
configuration, as follows: 

• In a standard VAX/VMS configuration with either RK07, RA60, or 
magnetic tape distribution media, the LIBRARY save set is restored and 
then the OPTIONAL save set is restored. 

• If you are using an RL02 distribution media, the upgrade restores the 
optional save set from the first RL02. The procedure then prompts you to 
remove the disk and insert the first of 2 LIBRARY disks. 



1.3.3.4 Upgrade Phase 3 

Phase 3 of the upgrade merges the VAX/VMS-distributed files that are 
commonly edited by system managers with new VAX/VMS files. Ignore any 
"file not found" error messages that appear at this time. 

The procedure modifies HELPLIB.HLB, DCLTABLES.EXE, STARLET.OLB, 
and IMAGELIB.OLB to preserve layered product installations; the procedure 
adds modules from the original files to the new copies. 

Next, the upgrade procedure merges all the miscellaneous user files that exist 
in the old system directories into a new set of system directories, temporarily 
called [SYSF.SYSEXE], [SYSF.SYSMGR], [SYSF.SYSLIB], and so on. The 
amount of time the merge takes depends on the number of user files. 



1 .3.3.5 Upgrade Phase 4 

If you are upgrading a VAX 8500, VAX 8550, VAX 8700, or VAX 8800, refer 
to Upgrade Phase 4B. For all other processors, refer to Upgrade Phase 4A. 

Upgrade Phase 4A 

During this phase of the upgrade, the procedure modifies the new site-specific 
console volume to allow reboot of the complete VAX/VMS Version 4.6 
system. Be sure the new site-specific console volume created in Phase 1 is 
in the console drive (CSAl: for VAX-11/780, VAX-11/785, VAX 8600 or 
8650 (original RL02), VAX 8200/8300 and VAX-1 1/750 systems; CSA2: for 
VAX-1 1/730 and VAX-11/725 systems). 
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When the modification is completed, the following message is displayed: 

System shutting dovm to boot the complete Version 4.6 system. 

Leave the newly created site-specific console volume in the console drive. 
The system disk must also remain where it is for the next phase of the 
upgrade to proceed. The system attempts an automatic reboot after the 
shutdown. 

If the system fails to boot because of insufficient nonpaged dynamic memory, 
you must use a standard conversational bootstrap to increase the NPAGEDYN 
(nonpaged dynamic memory) system parameter as described in previous 
sections. 

If needed, invoke the conversational boot command procedure for your 
system disk. For example, if the system disk is on the first MASSBUS device, 
invoke DBOGEN; if the system is on the first UDA device, DUOGEN, and so 
forth. 

When the boot is completed, the following message is displayed: 

VAX/VMS Version 4.6 «iate hh:iiim> 

Upgrade Phase 4B 

During this phase, the procedure fixes back-links for system directories, then 
shuts down the system. After the procedure shuts down the system, you 
must modify DEFBOO.COM and dddGEN.COM to boot from your original 
system root, typically SYSO. To modify DEFBOO.COM and dddGEN.COM, 
do the following: 

• At the P/OS DCL level, use an editor to modify DEFBOO.COM and 
dddGEN.COM to deposit the original value to R5 at bits <31:28> . To 
access the EDT editor, enter RUN EDT at the P/OS DCL prompt. Enter 
the name of the file to be modified (DEFBOO.COM or dddGEN.COM) 
at the EDT prompt. You must modify the line that has the following 
comment: 

! Software boot control flags and 
root directory # in <31:28>. 

For DEFBOO.COM, change the line to read (assuming you are booting 
from SYSO): 

DEPOSIT R5 

For dddGEN.COM, change the line to read: 

DEPOSIT R5 1 

After modifying DEFBOO.COM and dddGEN.COM, reboot the system by 
entering console mode and issuing the following command: 

>» B 

When the boot completes, the system displays the following message: 
VAX/VMS Version 4.6 <date hh:mm> 
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1.3.3.6 Upgrade Phase 5 

Phase 5 of the upgrade procedure creates a new site-specific SYSGEN 
parameter file, AUTOGEN.PAR, that combines the default values for 
Version 4.6 and the site-specific values you were using for the Version 4.4 or 
4.5 system. 

The upgrade procedure cleans up several directories, announces that the 
upgrade to Version 4.6 is complete, and displays several informational 
messages that describe optional tasks. After all the informational messages 
are displayed, the system shuts down and automatically reboots. 



1 .3.4 Post-Upgrade Procedures 

This section describes the mandatory and optional procedures to perform after 
the upgrade procedure has finished. Refer to the Guide to VAX/VMS Software 
Installation or the VAX/VMS System Manager's Reference Manual for further 
information about the subjects discussed in this section. 



1 .3.4.1 Mandatory Post-Upgrade Procedures 

The following steps must be performed after the upgrade has finished: 

1 Restore any SYSGEN parameters (such as SCSNODE, ALLOCLASS, 
SCSSYSTEMID, STARTUP_P1, or VAXCLUSTER) that may have been 
modified to allow the upgrade to proceed. 

If you upgraded a VAX 8500, VAX 8550, VAX 8700, or VAX 8800, 
you must restore the original contents of DEFBOO.COM and 
dddGEN.COM. Since you copied the original versions to DEFBOO.SAV 
and dddGEN.SAV, issue the following commands from the P/OS DCL 
command level: 

$ RENAME DEFBOO.SAV DEFBOO.CQM 
$ RENAME dddGEN.SAV dddGEN.COM 

2 Install the mandatory update. 

After you have upgraded to VAX/ VMS Version 4.6, but before you 
have installed any VAX/VMS options, you must install the additional 
mandatory update. 

The mandatory update has one of the following labels: 

• VAX/VMS V4.6 BINRXOl Mandatory Update 

• VAX/VMS V4.6 BIN16MT9 Mandatory Update 

• VAX/VMS V4.6 BINTU58 Mandatory Update 

• VAX/VMS V4.6 BINTK50 Mandatory Update 

• VAX/VMS V4.6 BINRX50 Mandatory Update 

Use the following procedure to install the mandatory update: 

a Log in to the System Manager's account (SYSTEM). 

b Ready the mandatory update media on the device drive that you will 
be using. 
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c Enter the following command: 

$ OSYS$UPDATE:VMSINSTAL VMSMUP046 device-name 

Enter the device-name in the form ddcu. 

The procedure prompts you for certain information (for example, whether 
you have inserted the mandatory update and are ready to proceed). Upon 
completion, the procedure shuts down the system, after which you must 
reboot. 

3 Reinstall DECnet if you are running DECnet. This product must be 
reinstalled. 

4 Rebuild the Standalone Backup Kit. Refer to the Guide to VAX/VMS 
Software Installation for instructions. 

5 To preserve previous layered product installations, the Version 4.6 
Upgrade Procedure merges the old and new versions of the following 
files: 

[SYSLIB] DCLTABLES . EXE 
[SYSHLP]HELPLIB.HLB 
[SYSLIB] STARLET. OLE 
[SYSLIB] IMAGELIB . OLB 

6 The procedure places the latest versions of the following .COM files on 
your new system disk. Examine these files; the original versions may 
have site-specific changes that will be lost if you purge them. Edit the 
new versions as appropriate to your system. 

[SYSMGR] SYL0GIN.COM 
[SYSMGR] SYSTARTUP . COM 
[SYSMGR] SYCQNFIG . COM 
[SYSMGR] SYSHUTDWN . COM 

Note: If you are upgrading a common system root (SYS$COMMON) as part 
of a cluster upgrade, the new files will be the most recent versions in 
SYS$COMMON; they will not be in the system specific root. 



1 .3.4.2 Optional Post-Upgrade Procedures 

This section contains optional, but recommended, procedures for you to 
perform on your system. 

Decompressing the System Library 

Many system libraries are shipped in a compressed format. If you have 
enough disk space on your system, you can decompress the libraries to gain 
faster access. If you do not decompress the libraries, you adversely affect the 
performance of the HELP and LINK commands. 

To decompress libraries, use the following command: 

$ aSYS$UPDATE:LIBDECOMP 

The decompressed libraries require approximately 5000 additional blocks 
of disk space. Depending on the type of processor you are using, the 
decompression process may take up to two hours. Generally, HELP libraries 
increase in size by 50 percent, while OBJECT libraries increase by 25 percent 
when decompressed. 
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Special File Handling 

After the completion of the upgrade, you may wish to delete files no longer 
needed. Be careful not to delete any edited files and shareable images that 
may be essential to the operating system. 

The upgrade procedure preserves the following files: 

[SYSEXE] NOTICE . TXT 
[SYSEXE] RIGHTSLIST . DAT 
[SYSEXE1SYSUAF.DAT 

Delete the following files after the upgrade has completed: 

[SYSEXE] STARTUP . UPS 
[SYSEXE] UPGRADE . KIT 

The size of the following files may have been changed to fit the system. 
Check these files to be sure that the sizes are appropriate: 

[SYSEXE] SYSDUMP.DMP 
[SYSEXE] PAGEFILE. SYS 
[SYSEXE] SWAPFILE . SYS 

Section 1.3.2, Step 4 explains how to modify the size of these files. 

Installed Images 

The procedure creates the file SYS$MANAGER: VMS1MAGES.DAT as part of 
the upgrade. SYS$MANAGER:VMSIMAGES.DAT lists files that the upgrade 
installed for enhanced system performance. Some files in this list may already 
be installed in the SYS$MANAGER:SYSTARTUP.COM file; delete the names 
of these files from the installation section of STARTUP.COM. 



1 .4 Upgrading VAXcluster Systems 



The high degree of sharing achieved among systems in a VAXcluster is the 
result of coordination at many levels of VAX/ VMS. This level of coordination 
generally cannot be achieved across major or minor releases of VAX/VMS. 
Therefore, all members of a VAXcluster must run the same version (major and 
minor) of VMS. In addition, VAXcluster sites must be prepared to upgrade all 
VAX systems in a cluster at the same time. 

Note: To upgrade a Local Area VAXcluster, perform the Version 4.6 Upgrade 
on the boot member of the cluster, then reboot the system. For more 
information on upgrading and installing Version 4.6 on Local Area 
VAXclusters, see the VMS Local Area VAXcluster Manual. 

An understanding of the following terms is useful in understanding the 
discussions in this section: 

Common system root Directory structure residing on a common system 

disl< containing the system files that are shared by 
several processors In a cluster environment 

Private system root Directory structure residing in either a private, local, 

or shared system disk in which the system files are 
used by a single processor in a cluster environment 

System root Generic term referring to either a common system 

root or a private system root 
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VAX/VMS Version 4.6 cannot coexist in a cluster with Version 4.4 or earlier 
versions of the operating system. Versions 4.6 and 4.5 can be intermixed 
in VAXcluster configurations, but only for the purpose of incrementally 
upgrading the various systems in the VAXcluster and testing the newly 
upgraded operating system on VAXcluster members. 

During the time that mixed versions of VAX/VMS are operating in a cluster, 
you must consider the following factors: 

• All systems booted from a common system root must run the same 
version of VAX/VMS. 

• You must set SYSGEN parameter VMSDl to 1 on all Version 4.6 nodes 
if a Version 4.5 system exists on the cluster. This is necessary for proper 
operation of the batch/print facility and RMS in a mixed version cluster. 
After all nodes have been upgraded to Version 4.6, reset SYSGEN 
parameter VMSDl to 0. 

• When a VAX/VMS Version 4.6 system boots in the presence of a Version 
4.5 system, the system console displays the following informational 
message: 

y.CSP-I-DIFSWVER. different versions of VAX/VMS exist in cluster 

• Complete the upgrade from Version 4.5 to Version 4.6 on all system roots 
of the cluster as quickly as possible. 

Given these restrictions, there are two methods of applying the upgrade to an 
entire cluster: 

Rolling upgrade Use this method for a VAXcluster that has multiple 

system roots (that is, any combination of private 
system roots and/or common system roots). Old 
and new versions of VAX/VMS temporarily exist 
simultaneously in the same cluster as you apply 
the upgrade to each system root. This method 
thus enables old and new versions of VAX/VMS to 
temporarily exist together in the same VAXcluster. 
(See Section 1 .4. 1 .) 

Concurrent upgrade Use this method for a VAXcluster that has a 

single common system root. The entire cluster 
is unavailable while the upgrade is applied to 
the common system root. When the upgrade is 
complete, the cluster is brought back up to run the 
upgraded version. (See Section 1.4.2.) 

When upgrading a common system root during either a rolling upgrade or a 
concurrent upgrade, you need to perform only one complete upgrade from 
one of the nodes that shares the common system root. However, you might 
need to modify the console boot command files as well as manually invoke 
AUTOGEN to update the system configuration parameters. Alternatively, 
you can use the MAKEROOT command procedure to create new alternate 
roots for these nodes. (See Section 1.4.3.1 or the Guide to VAXclusters for 
additional information.) 



1-27 



Upgrading to VAX/VMS Version 4.6 



1 .4.1 Upgrading a VAXcluster Environment: Rolling Upgrade 

A rolling upgrade is the method used to apply ar\ upgrade to a VAXcluster 
with multiple system roots (that is, any combination of private and/or 
common system roots). In a rolling upgrade, you apply the upgrade to each 
system root individually, causing new and old versions of VAX/VMS to exist 
together temporarily in the same VAXcluster. As a result, a rolling upgrade 
maintains partial system availability during an upgrade. (See Chapter 5 of the 
Guide to VAXclusters for additional information.) 

A rolling upgrade is not applicable when all systems boot from a single 
common system root. 

Perform the following steps, as appropriate, for each common system root or 
private system root in the cluster: 

1 Check the votes and make adjustments to maintain the proper quorum 
that allows the cluster to continue operating throughout this process. 
(Chapter 5 of the Guide to VAXclusters describes this procedure in detail.) 

2 Complete all the steps in Section 1.3.2 of these release notes. 

If you are upgrading a private system root, go to step 3. 

If you are upgrading a common system root, you need to perform only one 
complete upgrade from one of the nodes that shares that root. For all 
systems on a common system root, except the one from which you apply 
the upgrade, perform the following actions: 

a Shut down the system, using your site's standard shutdown 
procedure. (See Section 4.1.1 of the VAX/VMS System 
Manager's Reference Manual for a description of the 
SYS$SYSTEM:SHUTDOWN.COM command procedure.) 

b After you shut down a system on a common system root, issue the 
following command on one of the remaining nodes: 

$ SET CLUSTER/QUORUM 

This allows one node to continue running from the common system 
root (assuming other nodes running from different roots supply 
enough votes to sustain cluster quorum). 

If proper quorum is not maintained, the shutdown procedure hangs 
the cluster. In this event, enter the following commands to free the 
cluster: 



CTRL/P 



>» H 

>» D/I 14 C 
>» C 

IPO q 

IPO ICTRL/Zl 

3 Upgrade the single system according to Section 1.3.3 of these release 
notes. 

4 Manually reboot the upgraded system, as described in Section 4 of the 
VAX/VMS System Manager's Reference Manual. The upgraded version 
should now be running on the single system. 

When upgrading a common system root, reboot the other systems on the 
system root. This allows all systems on the common system root to run 
the upgraded version. 
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5 Proceed to Section 1.3.4. 

At this point, the cluster is running with mixed versions of VAX/VMS. 
You should now test and verify the new version before upgrading the 
other system roots. 

6 Repeat the tasks in this section, as appropriate for each system root, until 
all roots are running the upgraded version. 



1 .4.2 Upgrading a VAXcluster Environment: Concurrent Upgrade 

A concurrent upgrade is the method used to apply an upgrade to a VAXcluster 
that has a single common system root. A concurrent upgrade is performed 
by shutting down the entire cluster and applying the upgraded version to the 
common system root. When the upgrade is complete, boot each node in the 
cluster to start running the upgraded version of VAX/ VMS. All systems in the 
cluster are unavailable while a concurrent upgrade is being performed. 

Perform the following steps to perform a concurrent upgrade on your 
VAXcluster: 

1 Note the current values for all votes and quorum. You will restore these 
values after the upgrade has completed. Use the following commands: 

$ RUN SYS$SYSTEM:SYSGEN 
SYSGEN> USE CURRENT 
SYSGEN> SHOW VOTES 
SYSGEN> SHOW QUORUM 
SYSGEN> EXIT 

See Chapter 5 of the Guide to VAXclusters for additional discussion of this 
procedure. 

2 Shut dov«i the entire cluster, using your site's standard shutdown 
procedure. (See Section 4.1.1 of the VAX/VMS System Manager's Reference 
Manual for a description of the SYS$SYSTEM:SHUTDOWN.COM 
command procedure.) 

3 Perform a conversational boot on a single VAX system and set the votes 
and quorum values to 1 as follows: 

SYSBOOT> USE CURRENT 
SYSBOOT> SET VOTES 1 
SYSBOOT> SET QUORUM 1 
SYSBOOT> CONTINUE 

See Section 4.2,3 of the VAX/VMS System Manager's Reference Manual for 
further discussion of the conversational boot procedure. 

4 Install the Version 4.6 upgrade as described in Sections 1.3.2 and 1.3.3. 
This applies the upgrade to the root from which the system is booted. 
The upgrade procedure automatically performs an orderly shutdown of 
this system when it completes. 

5 Perform a conversational boot of this system, issuing the necessary 
SYSBOOT commands to restore the original settings of votes and quorum 
on this system as recorded in step 1. 
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Reboot the entire cluster according to your normal operating procedures. 
The entire cluster is now running the upgraded version of VAX/ VMS. 

Proceed to Section 1.3.4 to perform post-upgrade procedures. After 
performing post-upgrade procedures, refer to Section 1.4.3. 



1 .4.3 After the Cluster Upgrade 



This section contains procedures to perform after you have finished upgrading 
your cluster. 



1 .4.3.1 Updating Console Media 

When upgrading a VAXcluster to VAX/VMS Version 4.6, you need only 
apply the upgrade once to a common system disk regardless of the number 
of systems that actually boot from that disk. However, you must place the 
Version 4.6 copy of VMB.EXE onto your system's console media. 

If your system is a VAX 8800, VAX 8700, VAX 8550, or VAX 8500, you can 
skip this step, since the new VMB.EXE is shipped with the console media. 

For a VAX-11/730 or VAX-11/725— or a VAX-11/750 that does not boot 
from a TU58 tape cartridge — perform the following steps: 

a Invoke the System Generation Utility (SYSGEN) and connect the console 
by entering the following commands: 

$ RUN SYS$SYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 

b Insert the console TU5 8 in CSAl. 

c Copy VMB.EXE to CSAl using the Exchange Utility (EXCHANGE), as 
follows: 

$ EXCHANGE 

EXCHANGE> COPY/LOG SYS$SYSTEM : VMB . EXE CSAl: 

EXCHANGE> EXIT 

For all other VAX processors, invoke the console update command procedure 
SYS$UPDATE:UPDATE_CONSOLE.COM as follows: 

$ (aSYS$UPDATE:UPDATE_CONSOLE 

If your system is a VAX 8650, VAX 8600, VAX 8300, or VAX 8200, this 
procedure will copy the new file onto your existing console media. 

If your system is a VAX-11/780, VAX-11/782, VAX-11/785, or VAX-11/750, 
this procedure will use EXCHANGE to save the contents of your existing 
console. It will then merge the new files on the saved copy of your console 
media. Finally, it will request that you insert a scratch medium so that it 
can create new console media containing the new file. Your original console 
media will not be modified. 



1 .4.3.2 Creating Alternate Roots on a Common System Disk 

If you chose to create a common system root during the upgrade procedure, 
you may want to perform the procedures in this section so that other 
processors can also boot from the common system root. 
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In a VAXcluster that features a common system disk, use the 
MAKEROOT.COM command procedure to create system roots for nodes 
other than the first node of the cluster. To invoke MAKEROOT, enter the 
following command: 

$ fflSYS$MANAGER: MAKEROOT 

Note that MAKEROOT aborts if the system disk is not a cluster-common 
system disk, or if the SYSGEN parameter VAXCLUSTER is 0. 

When MAKEROOT executes, it requests the name of the new system root. 
Enter the root name using the form SYSx, where x is a hexadecimal digit 
between 1 and D (for example, SYSl or SYSA). Note that system roots SYSE 
and SYSF are reserved for other system functions. 

You may not specify the root of the currently running system (usually SYSO). 
If you specify any other existing system root, the procedure asks if you want 
to modify the existing system root. If you answer YES, MAKEROOT deletes 
the following root files: 

• [SYSEXElMODPARAMS.DAT 

• [SYSEXEJVAXVMSSYS.PAR 

• [SYSMGR]VMSIMAGES.DAT 

If a SYSCOMMON directory exists in the directory tree, MAKEROOT deletes 
it. Note that MAKEROOT does not check the format of the existing system 
root. DIGITAL recommends that you delete the directory tree or choose a 
different root. 

Next, the MAKEROOT command queries for the new node name and its 
SCSSYSTEMID. The node name can be no more than six characters. After 
you specify the node name and the value of SCSSYSTEMID, MAKEROOT 
queries for the size of the page file and swap file of the new root. AUTOGEN 
subsequently uses these values. 

Finally, MAKEROOT creates the new directory tree, the page file, and the 
swap file. It also generates a VAXVMSSYS.PAR file for the new root using 
the SYSGEN parameters of the currently running node as the basis for 
the new node. When completed, the system displays a series of messages 
describing how to build the console media for the new system. After you 
build the new console media, the system must be rebooted. When the system 
is running, invoke AUTOGEN as follows: 

$ eSYS$UPDATE: AUTOGEN SAVPARAMS REBOOT 



1 .4.3.3 Sharing the DECnet Permanent Database 

With VMS Version 4.6, you can share components of the DECnet 
permanent database among nodes in a homogeneous VAXcluster. These 
components are created in SYS$SPECIFIC:[SYSEXE] in a normally 
configured node. For example, the permanent object database should be 
SYS$SPECIFIC:[SYSEXE]NETOBJECT.DAT. If the permanent object database 
is identical on every cluster node, it can be shared as follows: 

1 Copy the permanent object database on one node to the common system 
root. For example: 

$ COPY SYSSSPECIFIC: [SYSEXElNETDBJECT.DAT - 
_$ SYSSCOMMON: [SYSEXEjNETOBJECT.DAT 
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2 Delete the permanent object database from the private system root on 
each node in the VAXcluster. For example: 

$ DELETE SYS$SPECIFIC: [SYSEXE1NETDBJECT.DAT;* 

To share the permanent remote node database (NETNODE_REMOTE.DAT) 
on the VAXcluster, perform the following procedure after you have upgraded 
one node and have rebooted the remaining nodes: 

1 On the node that performed the upgrade, rename the permanent remote 
node database to the common system root as follows: 

$ RENAME SYS$SPECIFIC: [SYSEXElNETNODE_REMOTE.DAT - 
_$ SYS$COMMON: [SYSEXElNETNODE_REM0TE.DAT 

2 On each other node in the homogeneous VAXcluster, create the 
permanent local node database as follows; 

$ RUN SYS$SYSTEM:NCP 
NCP> LIST EXECUTOR 

For additional information on the permanent database, see Chapter 5 of the 
VAX/VMS Networking Manual. 



1 .4.3.4 Running AUTOGEN 

DIGITAL recommends that you run AUTOGEN on each node of a cluster 
after completing a cluster upgrade. 
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This chapter discusses new features of the operating system for Version 4.6. 
It also describes features that have changed since the release of Version 4.5. 

The material in this chapter is organized as follows: 

Section 2.1^General User Information 
Section 2.2 — System Manager Information 
Section 2.3 — Application Programmer Information 
Section 2.4 — System Programmer Information 



2.1 General User Information 



The following section describes the new features of VAX/ VMS Version 4.6 of 
interest to the general user. It also discusses changes to the operating system 
since Version 4.5. 



2.1 .1 SET TIME Command — New CLUSTER Qualifier 

The DCL command, SET TIME, has the following new qualifiers: 

/CLUSTER 
/NOCLUSTER 

Use the /CLUSTER qualifier to update the time on all nodes present in the 
VAXcluster. By default (/NOCLUSTER), the command updates the time only 
for the node on which you enter the command. SET TIME/CLUSTER does 
not affect systems that are not in the VAXcluster. 

If you use the SET TIME/CLUSTER command without a new time value, the 
system reads the time-of-year clock on the local node, then sets all nodes in 
the cluster to that time. 

Because of communications and processing delays, the command cannot 
synchronize clocks exactly; the variation is typically less than a few 
hundredths of a second. If the con\mand cannot verify that the time was 
set to within one half second of the specified time, you receive a warning 
message that specifies the name of the node that failed to respond quickly 
enough. 

As a result of slight inaccuracies in each interval clock, times on the various 
members of a cluster tend to drift apart. You can use the following procedure 
to keep the cluster reasonably synchronized: 

$ SYNCH.CLOCKS : 

$ SET TIME /CLUSTER 

$ WAIT 6:00:00 

$ GOTO SYNCH.CLOCKS 

This procedure sets the time on all cluster nodes to the value obtained from 
the local time-of-year clock, waits, then resets the time for the cluster. 

For more information about the SET TIME command, see the VAX/VMS DCL 
Dictionary. 
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2.1 .2 SET HOST/DTE/DIAL Command — Modem Support 



The SET HOST/DTE/DIAL DCL command now supports the following 
modems: 

• DF03 

• DF112 

• DMCL (any modem that uses DIGITAL Modem Control Language) 



2.1.3 Support for New VT300 Series Terminals 



Version 4.6 provides support for the new VT300 series terminals. The 
terminal device type is VT300_SERIES, and the terminal characteristic is 
DEC_CRT3. The DEC_CRT3 characteristic indicates the following: 

• ISO LATIN- 1 character set resident 

• The ability to display a twenty-fifth status line 

• The ability to report explicit state information about itself 

When entering the SET TERMINAL command, you can specify VT300_ 
SERIES as a terminal type for the /DEVICE-TYPE qualifier. You can also 
supply a value of 3 to the /DEC_CRT qualifier, which sets the DEC_CRT3 
terminal characteristic. 



2.2 System Manager Information 



The following section describes the new features of VAX/VMS Version 4.6 
of interest to the system manager. It also discusses changes to the operating 
system since Version 4.5. 



2.2.1 AUTOGEN Enhancements 

The following sections describe Version 4.6 AUTOGEN enhancements. 



2.2.1.1 OLDSITE Parameter- Passing Mechanism Becoming Obsolete 

The MODP ARAMS parameter-passing mechanism supersedes the OLDSITE 
mechanism. The transition to the MODP ARAMS mechanism involves 
two steps. First, Version 4.6 eliminates SYS$SYSTEM:OLDSITEl.DAT. 
Second, the next major release will eliminate SYS$SYSTEM:OLDSITE2.DAT, 
OLDSITE3.DAT, AND OLDSITE4.DAT. 

The parameter values created by the files OLDSITEn.DAT can be found in the 
file SYS$SYSTEM:PARAMS.DAT. These parameter values are indicated by 
comment lines specifying which OLDFILEn.DAT the parameters come from. 
DIGITAL recommends that you review those parameters in the most recent 
version of SYS$SYSTEM:PARAMS.DAT. 

If, when you review SYS$SYSTEM:PARAMS.DAT, you find parameters that 
were transferred from OLDSITEn.DAT files that you feel are necessary for 
your site, include the records for these parameters from PARAMS.DAT in 
SYS$SYSTEM:MODP ARAMS.DAT. If MODPARAMS.DAT does not exist, it 
may be created with any text editor. 
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After updating MODPARAMS.DAT to reflect the parameters transferred from 
the OLDSITEn.DAT files, invoke AUTOGEN as follows: 

I8SYS$UPDATE:AUT0GEN GETDATA REBOOT INITIAL 

For more information about the MODP ARAMS parameter-passing 
mechanism, refer to Section 11.4 of the VAX/VMS System Manager's Reference 
Manual. 



2.2.1 .2 New WSMAX Check 

Since a value for WSMAX that is too high can disable pool expansion, 
AUTOGEN now displays a warning if it discovers a user-supplied value for 
WSMAX that appears to be too high. 



2.2.1 .3 Current Parameter Values Saved In 

SYS$SYSTEM:VAXVMSSYS.OLD 

AUTOGEN now saves current system parameters in 
SYS$SYSTEM:VAXVMSSYS.OLD before updating these parameters in 
SYS$SYSTEM:VAXVMSSYS.PAR. 



2.2.1 .4 Specifying an Alternate Startup Command Procedure in 

MODPARAMS.DAT 

If you use a startup command procedure other than 
SYS$SYSTEM:STARTUP.COM, you can now assign the name of your 
procedure to the symbol STARTUP in MODPARAMS.DAT. After invoking 
AUTOGEN, your procedure becomes the default startup command procedure. 

For example, to specify MY_STARTUP.COM as the new default startup 
command procedure, make the following entry in MODPARAMS.DAT: 

STARTUP = "SYS$MANAGER: MY_STARTUP.COM" 



2.2.1 .5 QUORUM Value Now Calculated 

For Version 4.6, AUTOGEN calculates a value for the QUORUM parameter 
by selecting the higher of the following two values: the initial quorum, or the 
current cluster quorum. 



2.2.2 Page and Swap File Handling — Improvements 



Version 4.6 improves the way AUTOGEN handles page and swap files. 
AUTOGEN now understands and manipulates secondary files. Generally, if 
secondary page or swap files exist, AUTOGEN's file manipulation involves 
secondary files but excludes primary files; AUTOGEN assumes that primary 
files are on a cluster common system disk. The foUov^dng list describes how 
AUTOGEN handles different types of input: 

1 If AUTOGEN does not receive user-supplied information from 
MODPARAMS.DAT, it performs default page and swap file size 
calculations. If no secondary files exist, AUTOGEN applies any changes 
to the primary files. If secondary files exist, AUTOGEN applies changes 
evenly across all secondary page or swap files but does not modify 
primary files. 

2 AUTOGEN can receive general user-supplied size information from 
MODPARAMS.DAT. This information consists of records of the form 
PAGEFILE = n or SWAPFILE = n. If n is zero, the corresponding section is 
skipped. If n is not zero and no secondary files exist, AUTOGEN applies 
the value to primary files. If n is not zero and secondary files exist. 
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AUTOGEN applies any change evenly across all secondary files but does 
not modify primary files. 

3 For Version 4.6, you can specify the individual sizes of all existing page 
and swap files (including secondary files) as well as the location and 
size of new files that you want AUTOGEN to create. To do this, define 
symbols in MODPARAMS.DAT using the following format: 

{PAGE/SWAP}FILEn_{NAME/SIZE} 

In this format, n is an integer that specifies the page or swap file. Refer 
to the primary page and swap files by specifying a value of 1 for n; refer 
to subsequent files by specifying increasingly higher integer values for n. 
For example, to refer to a secondary page or swap file, you could specify 
a value of 2 for n. Braces ( (} ) indicate that you must choose between 
the options delimited by a backslash ( / ). For example, specify PAGE or 
SWAP, NAME or SIZE. 

For existing files, you typically define _SIZE symbols only; AUTOGEN 
already has the name and location. For example, to direct AUTOGEN 
to set the primary page file size to 10,000 blocks, you would use the 
following symbol definition: 

PAGEFILEl.SIZE = 10000 

To direct AUTOGEN to create a new secondary swap file named 
PAGED$:[PAGESWAP]SWAPFILE.SYS that holds 30,000 blocks, you 
would use the following symbol definitions: 

SWAPFILE2_NAME = "PAGED$: [PAGESWAP]SWAPFILE.SYS" 
SWAPFILE2_SIZE = 30000 

Note that you must manually edit SYS$MANAGER:SYSTARTUP.COM 
to include a SYSGEN command that installs the newly created secondary 
file. 

You cannot specify both general and explicit information as described in 
numbers 2 and 3 above. AUTOGEN issues a warning if conflicting S3mibol 
definitions exist in MODPARAMS.DAT. 

If the creation or extension of a file would cause the target disk to become 
more than 95 percent full, AUTOGEN issues a warning and does not perform 
the operation. 

For more information about AUTOGEN, refer to Section 11.1 of the 
VAX/VMS System Manager's Reference Manual. 



2.2.3 Primary Page and Swap Files on Disks Other than the System Disk 

Version 4.6 allows you to have primary page and swap files on disks other 
than the system disk. 

Page and swap files in SYS$SYSTEM are installed. If no page and swap files 
exist in SYS$ SYSTEM, a message informs you that the files were not found. 
For example, you might receive the following message: 

%SYSINIT-I-PAGEFILE.SYS not found - system initialization continuing... 
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To install page and swap files on any disk, create the file 
SYS$MANAGER:SYP AGSWPFILES.COM. In SYPAGSWPFILES.COM, 
specify the MOUNT and SYSGEN INSTALL commands that install page 
and swap files. The following example demonstrates some of the commands 
you might use: 

$ RUN SYS$SYSTEM : SYSGEN 

INSTALL DISK_SYS2: [SYSTEM] PAGEFILEl. SYS /PAGEFILE 

INSTALL DISK_SYS2: [SYSTEM] SWAPFILEl. SYS /SWAPFILE 

Immediately before system overhead processes are created (for example, 
OPCOM and JOBCTL), STARTUP.COM searches for and executes 
SYPAGSWPF1LES.COM. 

After SYPAGSWPFILES.COM executes, control returns to STARTUP.COM. If 
no page files have been installed, STARTUP.COM returns the following error 
message: 

'/iSTARTUP-E-NOPAGFIL , no page files have been successfully installed. 

Use SYPAGSWPFILES.COM observing the following restrictions: 

• To use the primary page file for writing crash dumps, the primary page 
file must be located on the system disk. 

• Disks mounted by SYPAGSWPFILES.COM must not be mounted by other 
processors during upgrades where SYSGEN parameter VAXCLUSTER is 
set to zero. 



2.2.4 MTHRTL — System-Wide Logical Name 



SYS$SYSTEM:STARTUP.COM now defines the logical name MTHRTL as a 
system- wide logical name. The change was necessary for systems that needed 
UVMTHRTL; for consistency, the change was applied to all systems. 



2.2.5 LAT/VMS — New Features 

Version 4.6 includes new Local Area Transport (LAT) software. 

The new LAT/VMS software supports asynchronous printers connected to 
LAT terminal servers. The software consists of new LTDRIVER and LATCP 
software, as well as a new software component, LATSYM — the LAT print 
symbiont. 

Prior to Version 4.6, printer support was provided through the LATplus 
software; this software was included as part of the terminal server distribution 
kit. Version 4.6 includes an enhanced version of LAT as part of the operating 
system. In addition to having the LATplus features, LAT/VMS has a QIO 
interface that allows application programs to make host-initiated requests for 
connections to remote devices. If you originally installed LATplus as part 
of the terminal server kit, do not reinstall after performing the Version 4.6 
upgrade. 

Part II of this book contains complete documentation of 
the new LAT software, including instructions for modifying 
SYS$MANAGER:SYSTARTUP.COM and SYS$MANAGER:LTLOAD.COM. 
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The following new features are provided: 

• A QIO Interface for LTDRIVER functions. 

• LATCP user interface is new. 

• Terminal characteristics can be passed to the host. 

• The break character can be passed to the host. 



2.2.5.1 QIO Interface 

LAT/VMS 4.6 supports two QIO function code modifiers that allow 
application programs to request and terminate connections to remote devices 
on servers. These remote devices are mapped to an application device on the 
host. Refer to Chapter 4 of the LAT/VMS Management Guide for a complete 
description of these function code modifiers. 

A print queue can be set up to automatically access the remote device located 
on the terminal server. Similar print queues can be set up on other service 
nodes, allowing the printer to be shared by users on many service nodes. 
Requests for connections to the port are queued on the server and are serviced 
on a first-in/first-out basis when the port becomes available. 



2.2.5.2 New LATCP User Interface 

The LAT/VMS software implements a new LATCP interface. With the new 
features, LATCP does the following: 

• Adheres to DCL syntax standards 

• Allows up to eight services per node 

• Supports a SHOW PORTS command 

• Allows you to change a single characteristic for a node without affecting 
the other node characteristics 

• Allows a fixed service rating value to be specified 

Refer to the LAT/VMS Management Guide for a complete description of the 
LATCP commands. The Software Notes section discusses the LATCP SHOW 
PORTS display. 



2.2.5.3 Passing Terminal Characteristics 

Terminal servers can now pass information about terminals to the host. 
Speed, parity, and character size are passed to the service node on session 
start-up. The server also passes information on parity, framing, and overrun 
errors to the service node if an error occurs at the terminal. 

Terminal server users can pass the break character to a service node without 
the server interpreting BREAK as a request to go into local mode. 
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2.2.5 A Software Notes 

This section discusses some of the software features and restrictions, and 
supplements information in the LAT/VMS Management Guide. 

Rating Algorithm 

The service rating algorithm has changed to incorporate both the idle cpu 
time and the percentage of active users as follows: 

ijoblim - ijobcnt 

(100 * 7, cpu_idle_time + 155 * ) * cpu_type_factor 

ijoblim 

A penalty factor for small memory configurations is subtracted from the rating 
value as calculated in the algorithm shown. 

Therefore, it is very important that the interactive job limit be set to a realistic 
value for your system. This can be done in the system's SYSTARTUP.COM 
file with the following command. 

$ STARTUP$INTERACTIVE_LOGINS :== nn 

In this example, nn is a number that takes into account your processor 
type and user load. This command is typically the last command in the 
SYSTARTUP.COM file. 

SHOW PORTS Display 

The LATCP program now has a display that shows information about 
interactive and applications ports. The display shows the server name and 
port name for active connections. 



2.2.5.5 Problems with LAT-11 Software Layered Product 

This section discusses problems and limitations when using the LAT-11 
software that runs on a PDP-11 and that has been configured to serve 
terminals. 
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Cluster Nodes Not Accessible by LAT-1 1 

The LAT-1 1 software requires that the first service T\ame offered by a 
VAX/VMS node be the node name. For a VAXcluster, the cluster service 
name must be the second service offered by the VAX/VMS node. All other 
Digital terminal server products require only a cluster service name. Enabling 
the node name as a service is only necessary when using LAT-11. Add the 
following command line to your LTLOAD.COM file before the command line 
that creates the cluster wide service name: 

$ LCP CREATE SERVICE /IDENT /NOLQG 

The sample LTLOAD.COM file that follows shows you where to enter this 
command line. 



Example 2-1 Sample LTL0AD.COM File for Use with LAT-1 1 



$ ! This command procedure ststrts up the LAT protocol and is compatible 

$ ! with LAT- 11. 

$ 

$ RUN SYS$SYSTEM : SYSGEN 

CONNECT LTAO/NDADAPTER 

$ 

$! Invoke LATCP 

$ 

$LCP := $LATCP 

The following commands set up LAT service with the default name 
SYS$NODE and default ident SYS$ANNOUNCE . The first LAT service name 
defaults to the node name SYS$NGDE. YOU MUST SPECIFY a cluster wide 
service name as the first parameter in the command line. Use the 
remaining parameters to specify values for other node characteristics, 
such as group codes. 

$LCP SET NODE /IDENT 'P2' 'P3' 'P4' /NOLOG 

$LCP CREATE SERVICE /ID ! Fix for lat-11 bug 

$LCP CREATE SERVICE 'PI' /IDENT /NOLOG ! Provide cluster service name as PI 

$LCP START NODE 

$! 



New Features Not Supported 

The LAT-11 software does not support the new functions provided by the 
VAX/VMS Version 4.6 LAT software. You cannot connect a remote printer 
to the LAT-11 software. However, all LAT functions previously supported by 
LAT-11 still work with VMS Version 4.6. 



2.2.5.6 Miscellaneous LAT/VMS Problems 

This section discusses problems affecting the LAT/VMS software and 
suggested solutions for those problems. 

Delay in Process Disconnect 

If virtual terminals are enabled on your system and you enter a terminal 
server DISCONNECT command, the process does not immediately go away; 
it goes away when the timeout period expires. This is normal and should be 
expected. 
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LATCP STOP NODE Command 

The STOP NODE command deletes the current node characteristics. Avoid 
using the following sequence of commands: 

LCP> STOP NODE 
LCP> START NODE 

Instead of using these commands, invoke the LTLOAD.COM file as 
previously shown, or set up the characteristics for your node manually 
with the SET NODE and SET SERVICE commands. 

Note that if you issue a LATCP STOP NODE command, all LAT terminal 
users are disconnected from the node, and a process rundown is initiated. 

LATCP /QUEUE Qualifier 

When using the /QUEUE and /NOQUEUE qualifiers in the SET PORT 
command, exit LATCP and rerun LATCP before entering the command (for 
example, using the "LCP" foreign command will accomplish this). 

LTL0AD.COM and VIVIS Version 4.6 Installation 

The installation of VMS Version 4.6 overwrites any existing 
SYS$MANAGER:LTLOAD.COM file. This occurs because the LATCP 
command syntax has been completely redone since prior versions of VMS. 
Note that this situation also applies to a LTLOAD.COM file based on 
LATplus/VMS, in spite of its compatible syntax. If you want to continue 
using your existing LTLOAD.COM file, save it and restore it later. 

LATCP and the DELETE PORT command 

The DELETE PORT command does not correctly shut down a session 
when this is used on a port with an active session. Use the DELETE PORT 
command only for inactive application ports. 

Solicit Connection QIO 

Do not enter the solicit connection QIO if LATCP has not yet started the LAT 
protocol. The QIO request may not complete and will not return an error. 

LAT PASSALL Session 

When using a host-initiated connection with the UCB set to the PASSALL 
characteristic, the terminal server's input flow control for the port is disabled. 
This is normal behavior. 



2.2.6 Limited Support for Dual-Pathed HSC Tape Drives 

VAX/VMS Version 4.6 provides linuted support for dual-pathed HSC tape 
drives. This removes the previous restriction against any form of dual-pathed 
HSC tape drive and increases the usefulness of HSC tape drives in situations 
where high availability is important. 

A dual-pathed HSC tape drive is a drive that connects to two HSCs, both of 
which have the same nonzero tape allocation class. (The tape allocation class 
is set using the HSC console command SET ALLOCATE TAPE.) VAX/VMS 
recognizes the dual-pathed nature of such a tape drive, provided that it has 
access to both HSCs and that both port select buttons are depressed on the 
tape drive. 
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For dual-pathed tape drives, VAX/VMS automatically selects a functional 
HSC when processing a MOUNT or INITIALIZE command. However, if the 
selected HSC becomes inoperative while a tape is mounted, the tape must be 
dismounted and remounted in order to cause the alternate HSC to be used. 

Note: This mount-time failover feature should not be confused with automatic 
failover, which can occur without dismounting the unit. VAX/VMS 
provides automatic failover only for disk devices. (See the Guide to 
VAXclusters for a discussion of automatic failover.) 

Note that an HSC that becomes inoperative while I/O is pending is not 
declared inoperative until the timeout period specified by the SYSGEN 
parameter VMSD3 expires. VMSD3 should be set to a nonzero value which 
specifies the number of seconds to wait before attempting to fail over to the 
other port. 

Note also that due to a problem in the HSC software, a tape subsystem that 
has undergone a failover is declared inoperative by the failing HSC when 
the HSC reboots. To make the tape subsystem operative, you must toggle 
the port select button for the port connected to the failed HSC, or reset 
the tape subsystem. As a result, a tape subsystem cannot, without manual 
intervention, failover to a second HSC and then failover back to the original, 
in the event that the second HSC fails. 



2.2.7 CIBCA — New Device Support 



VAX/VMS Version 4.6 supports the CIBCA. The CIBCA is a two-board 
computer interconnect (CI) interface for the BI bus, and is functionally 
equivalent to the CIBCI. The CIBCA uses the same driver (PADRIVER) and 
device mneumonic (PA:) as the CIBCI, CI750, and CI780. The CIBCA also 
uses the same HSC booting and installation procedures as the CIBCI. 

CIBCA customers installing VAX/VMS Version 4.5 in a cluster without a 
CI780, CI750, or CIBCI required a special remastered kit. You can install 
Version 4.6 in CIBCA environments without a special kit. 



2.2.8 Network Control Program — SHOW CIRCUIT Command Changes 



Prior to Version 4.6, the Network Control Program's SHOW 
CIRCUIT ... SUMMARY command displayed circuit information about all 
adjacent nodes (routing and non-routing). For Version 4.6, the SUMMARY 
parameter displays circuit information about adjacent routing nodes only. 
However, the STATUS parameter continues to display circuit information 
about all adjacent nodes. For more information about the SHOW CIRCUIT 
command, refer to the VAX/VMS Network Control Program Reference Manual. 
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2.2.9 LOCKDIRWTSYSGEN Parameter 



Version 4.6 changes the way the Lock Database is rebuilt when nodes are 
added or removed from a VAXcluster while SYSGEN parameter LOCKDIRWT 
is set to zero. 

Prior to Version 4.6, setting LOCKDIRWT to zero on a VAXcluster node 
prevented that node from participating in the lock directory service, unless 
all member nodes had LOCKDIRWT set to zero. Version 4.6 retains the old 
behavior, but includes the following new feature: a node with LOCKDIRWT 
set to zero gives other nodes an opportunity to become resource managers 
before reacquiring locks during a cluster state transition. This feature tends 
to move management of shared resources away from a node that has a zero 
value for LOCKDIRWT. 

A zero value for LOCKDIRWT can be useful when the cluster contair\s a 
relatively low number of high-powered processors with a relatively high 
number of low-powered processors, where all processors access the same 
shared resources. Setting LOCKDIRWT to zero in this case tends to move 
resource management tasks to the larger processors and can reduce memory 
use on the smaller processors. 

DIGITAL recommends you use the value for LOCKDIRWT that AUTOGEN 
assigns. 



2.2.10 Monitor Utility Supports IVIonitoring of Additional Nodes 

The Monitor Utility (MONITOR) now supports monitoring of the maximum 
number of nodes allowable in a cluster — currently 28. 

However, insufficient process quotas of the following types can restrict the 
number of nodes you can monitor: 

• ASTLM 

• FILLM 

• JTQUOTA 

If necessary, use the Authorize Utility (AUTHORIZE) to adjust these values. 

An insufficient value for maximum logical links can also restrict the number 
of nodes you can monitor. If necessary, use the Network Control Program 
(NCP) to increase the value for maximum links. 



2.3 Application Programmer Information 

The following section describes the new features of VAX/ VMS Version 4.6 
of interest to the application programmer. It also discusses changes to the 
operating system since Version 4.5. 



2-11 



New and Changed Features 



2.3.1 Debugger — New Features 



2.3.1.1 Predefined Breakpoints 

If any portion of your program is written in VAX® Ada® , then the following 
two breakpoints are automatically established when you invoke the debugger 
(the output of a SHOW BREAK command is shown): 

Breakpoint on ADA event "DEPENDENTS_EXCEPTION" for any value 
Breakpoint on ADA event "EXCEPTION.TERMINATED" for any value 

These breakpoints are equivalent to issuing the following commands: 

DBG> SET BREAK/EVENT=DEPENDENT_EXCEPTION 
DBG> SET BREAK/EVEHT=EXCEPTION_TERMINATED 

Ada programmers find these breakpoints convenient for debugging tasking 
programs. 



2.3.1 .2 CALL from an Exception Breakpoint 

Prior to Version 4.6, you could not issue the CALL command directly after an 
exception breakpoint was triggered. This restriction has been removed. 

Some related restrictions still apply. If a routine is called with the CALL 
command just after an exception breakpoint was triggered, no breakpoints, 
tracepoints, or watchpoints set within that routine are triggered. However, 
they are triggered if the CALL command is given at another time. 



2.3.1 .3 STEP from an Exception Breakpoint 

Prior to Version 4.6 you could not issue the STEP command directly after an 
exception breakpoint was triggered. This restriction has been removed. 

Issuing a STEP command at an exception breakpoint causes you to step to the 
start of whatever exception handler gets control. If you have not declared any 
exception handlers, the exception is resignalled and the debugger prompt is 
displayed — that is, the STEP command has no effect. 



2.3.1.4 Non-static Watchpoints 

You can now set watchpoints on variables that are dynamically allocated, 
such as those on the stack or in registers. These are called nonstatic 
watchpoints. 

You can set a watchpoint on a nonstatic variable only when its defining 
routine is active. If you try to set a watchpoint on a nonstatic variable when 
its defining routine is not active, the debugger issues a warning, as in the 
following example: 

DBG> SET WATCH Y 

%DEBUG-W-SYMNOTACT , nonstatic variable 'Y' is not active 

To implement nonstatic watchpoints, the debugger must trace every 
instruction, slowing down the execution of the program being debugged. 
When you set a nonstatic watchpoint, the debugger determines whether 
the watched location is statically or nonstatically allocated. If the location is 
nonstatically allocated, the debugger issues an informational message that you 
are setting a nonstatic watchpoint, so that you will be aware of the slower 
performance. 



t® 



VAX is a trademark of Digital Equipment Corporation. 

Ada is a registered trademark of the U.S. Government (Ada Joint Program Office). 
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A nonstatic watchpoint is automatically canceled when execution returns from 
its defining routine, and an informational message is issued to that effect. 



2.3.2 VAX PASCAL Run-Time Library — Changes 



The following subsections describe Version 4.6 changes to the PASCAL 
Run-Time Library. 



2.3.2.1 Changes to DEC and UDEC 

• The default number of significant digits for the DEC and UDEC built-in 
routines has been changed from eight to ten. 

For example, consider the following code segment: 

WRITELN('<' ,DEC(12345) ,'>'); 

Prior to Version 4.6, this code generated the following: 

< 00012345> 

For Version 4.6, this code generates: 

< 0000012345> 

To duplicate previous behavior, specify the number of significant digits in 
calls to the DEC or UDEC built-in routines. 

• The default length parameter has been changed from 12 to 11 characters. 

For more information about changes to DEC and UDEC, see the release notes 
for VAX PASCAL, Version 3.5. 



2.3.2.2 Enhanced KEY Attribute 

For Version 4.6, the VAX PASCAL Run-Time Library includes support for the 
enhanced VAX PASCAL KEY attribute. The KEY attribute now accepts the 
following additional keywords: 

[NO] CHANGES 

[NO] DUPLICATES 

ASCENDING 

DESCENDING 



2.3.2.3 New Default RECORD-LENGTH for TEXT files 

For Version 4.6, the default record length for TEXT files increases from 133 
to 255 characters. To duplicate previous behavior, you must specify the 
following in your OPEN statement: 



RECORD.LENGTH := 133 



2.3.2.4 Use of EXTEND, REWRITE, and TRUNCATE on Shared Sequential 

Files 

Prior to Version 4.6, the VAX PASCAL Run-Time Library enforced solitary 
access to sequential fdes for the EXTEND, REWRITE, or TRUNCATE buih- 
in routines. Version 4.6 supports shared access to sequential files for these 
built-ins. 
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2.3.3 PL/I Run-Time Library Now Supports VAX PL/I Version 3.0 

The Version 4.6 PL/I Run-Time Library supports VAX PL/I, Version 3.0. 
The Run-Time Library contains several minor changes that support the PL/I 
SUBSCRIPTRANGE, STRINGRANGE, and STORAGE conditions; these 
changes are incompatible with previous versions of VAX PL/I. Specifically, 
the PL/I Run-Time Library has the following new primary condition values: 

• PLI$_SUBRG (replaces PLl$_SUBRANGEn) 

• PLI$_STRRANGE (replaces PLI$_SUBSTRn) 

• PLI$_STORAGE (replaces LIB$GET_VM) 

For each new primary condition value, the built-in ONCODE function returns 
the old primary status value. 

DIGITAL recommends that Version 4.6 customers upgrade to VAX PL/I, 
Version 3.0. If you choose to run a previous version VAX PL/I, you should 
recode where appropriate. For example, you might make the following code 
change: 

ON VAXC0NDITI0N(PLI$_SUBSTR2) BEGIN; 



END; 

Change to: 

DCL PLI$_STRRANGE GLOBALREF FIXED BIN (31) VALUE; 
ON VAXCONDITION(PLI$_STRRANGE) BEGIN; 

IF ONCODEO -= PLI$_SUBSTR2 

THEN 

CALL RESIGNALO; 

ELSE 



END; 
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2.3.4 VAX Ada Run-Time Library — Enhancement for Unhandled Exceptions 

VMS Version 4.6 improves the way the Ada Run-Time Library deals with 
unhandled Ada exceptions and VAX conditions. Exceptions and conditions 
are considered to be unhandled if they propagate as far as they can go — to 
the level of a task or a main program — and a VMS or VAX Ada Run-Time 
Library catch-all handler gains control. Catch-all handlers are located in 
frames enclosing the main program and library packages, each task body, and 
each accept body. 

Beginning with Version 4.6, new catch-all handler messages are produced, 
and changes to program execution behavior have been made, as follows: 

• If an unhandled VAX condition with a severity of success, information, 
warning, or error (any severity except severe) reaches an Ada Run-Time 
Library catch-all handler, the handler displays the condition message 
and continues program execution. This behavior is consistent with the 
behavior of VMS catch-all handlers. 

• If an Ada exception or a VAX condition with a severity of severe reaches 
an Ada Run-Time Library catch-all handler, the handler displays the 
exception or condition message, and then the task, main program, or 
rendezvous becomes completed. (Note, however, that when an exception 
or severe condition leaves an accept body, the message is not displayed 
because the exception or condition will propagate to both of the tasks 
involved in the rendezvous.) 

• The Ada Run-Time Library catch-all handlers display a warning when an 
unhandled exception may have to wait for dependent tasks to terminate. 

The new catch-all handler messages are directed to both SYS$OUTPUT and 
SYS$ERROR. 

Also beginning with Version 4.6, the point in the VAX Ada exception- 
handling sequence at which waiting for dependent tasks takes place has 
changed. Prior to Version 4.6, waiting for dependent tasks took place during 
the search for an applicable exception handler; with Version 4.6, waiting has 
been deferred until an applicable handler has been found. A more detailed 
explanation of this change follows. 

In VAX Ada, a general condition handler is automatically established for all 
stack frames that have exception handlers, and a run-time table of active 
exception parts is maintained for each frame. The general condition handler 
determines which Ada exception handler in the frame eventually gains 
control (if any). Any subsequent Ada exception propagation takes place in 
two phases. During the first phase, the general condition handler determines 
which Ada exception handler should gain control; each frame on the stack is 
searched for this handler. When the applicable handler is found, the general 
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condition handler requests a stack unwind, and the second phase begins. 
During the second phase, each frame is removed from the stack. Prior to 
VMS Version 4.6, waiting for the termination of tasks dependent on some 
Ada frame took place during the first phase (search for a handler). Now, 
waiting for dependent tasks takes place during the second phase (unwind). 
After the unwind, the handler for the exception executes. 

The Version 4.6 exception-handling improvements will have the following 
effects: 

• Programs written entirely in Ada will not be visibly affected by the 
change in the point at which waiting for dependent tasks takes place. 
Such programs will be affected only by the new catch-all handler error 
messages and by continuation of the main program in cases of nonsevere 
unhandled exceptions. 

• Software (such as the CLI) that signals a condition in order to print 
a message, expecting continuation at the point of the signal, is now 
supported — provided that the program does not handle the condition 
(exception) before the condition gets to the Ada Run-Time Library catch- 
all handlers. 

• Software that signals a nonsevere condition value with a call to the 
VMS Run-Time Library routine LIB$SIGNAL, but that does not want the 
continuation that LIB$SIGNAL usually leads to, must call the Run-Time 
Library routine LIB$STOP instead, or use an Ada raise statement (if the 
signaling software is written in Ada). 

• A task no longer terminates silently because of an unhandled exception — 
the exception message is now displayed. In addition, the exception 
message will appear before waiting begins for dependent tasks (because 
such waiting may cause a deadlock). This will make Ada programs more 
robust because an unexpected exception in a production program will 
now generate a message. 

If you do not want your software to produce task termination messages, 
you may want to have exception handlers in those task bodies to which 
you expect unhandled exceptions to propagate. For example, if you expect 
that the predefined exception END_ERROR will cause task termination 
messages in one of your tasks, you could have the following code, or its 
equivalent (the action need not be a null statement), in the exception part 
of the affected task body: 

when END.ERROR -> null; 

The handler absorbs the unhandled exception and prevents it from 
propagating further. The use of a handler in this situation also allows you 
to see that the termination resulting from this exception is to be expected. 

• The change in the point at which waiting for dependent tasks takes 
place may affect mixed-language programs. Prior to Version 4.6, an Ada 
exception that propagated to non-Ada code would cause execution to 
wait until all dependent Ada tasks terminated; a handler in the non-Ada 
code could not execute until the tasks terminated. With Version 4.6, 
the exception will be propagated, and dependent tasks will continue to 
execute; a handler in the non-Ada code may execute concurrently with 
the dependent tasks. 
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If some software beyond your control is adversely affected by the messages 
resulting from unhandled exceptions, you can hide the messages by defining 
the logical names SYS$OUTPUT, SYS$ERROR, and ADA$OUTPUT. Define 
SYS$OUTPUT and SYS$ERROR to be where you want the messages to go, 
and define ADA$OUTPUT to be where you want Ada output (from package 
TEXT_IO) to go. 

Note: You should redirect error-message output only as a temporary measure 
until you have modified your program as previously described. If you 
redirect SYS$OUTPUT, be careful to ensure that you do not miss other 
error messages that might occur; DIGITAL advises that you capture the 
output directed to SYS$OUTPUT and compare it with output containing 
the messages you would otherwise expect. 

For information about new features of the debugger that affect VAX Ada 
programs, see Section 2.3.1. 



2.3.5 VAX C Run-Time Library — Changes 



2.3.5.1 Function Restrictions Removed 

Prior to Version 4.6, printf functions could not format more that 512 
characters in a single call. For Version 4.6, printf functions accept formatted 
output of unlimited length. However, an individual field in the resulting 
string cannot be longer than 512 characters. 



2.3.5.2 File Sharing Now Supported 

Prior to Version 4.6, the VAX C Run-Time Library did not support file 
sharing. The Version 4.6 VAX C Run-Time Library supports file sharing when 
you use record mode to access files; you must use the ctx=rec file attribute 
with all file open functions. Specify the shr=xxx file attributes as appropriate. 



2.3.5.3 Stream I/O Facilities 

Version 4.6 improves stream I/O facilities in the VAX C Run-Time Library. 
You can now specify the mbc==nnn file attribute when opening stream files. 
The value for this attribute specifies the number of blocks to allocate for I/O 
buffer. Reads and writes are performed using this block size. 

For more information about changes to the VAX C Run-Time Library, see 
current documentation for VAX C Version 2.3. 



2.4 System Programmer Information 



The following section describes the new features of VAX/VMS Version 4.6 of 
interest to the system programmer. It also discusses changes to the operating 
system since Version 4.5. 



2.4.1 System Services — New Item Codes 

The following item codes have been added to $GETSYI. 
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SYI$_XCPU 

When SYI$_XCPU is specified, $GETSYI returns the extended CPU processor 
type of the node. $GETSYI returns this information only for the local node. 

The general processor type value should be obtained first by using the SYI$_ 
CPU item code. For some of the general processor types, there is extended 
processor type information provided by the item code, SY1$_XCPU. For other 
general processor types, the value returned by the SYI$_XCPU item code is 
currently undefined. 

Since the processor type is a longword decimal number, the buffer length 
field in the item descriptor should specify 4 (bytes). 

The $PRDEF macro defines the symbols for the extended processor types. 
The current extended processor types available and their sjmibols are as 
follows: 



VAX 


Extended 


Extended 


Processor 


Processor 


Processor 


Type Symbol 


Type 


Symbol 


PR$_SID_TYPUV 


MicroVAX II 
VAXstation II 


PR$_XSID_UV_UV2 




MicroVAX 2000 


PR$_XSID_UV_410 




VAXstation 2000 




PR$_SID_TYP8NN 


VAX 8500 


PRS$_XSID_N8500 




VAX 8550 


PRS$_XSID_N8550 




VAX 8700 


PRS$_XSID_N8700 




VAX 8800 


PRS$_XSID_N8800 



SYI$_XSID 

When SYI$_XSID is specified, $GETSYI returns processor-specific 
information. For the MicroVAX II, this information is the contents of the 
system type register of the VAX node. The system type register contains 
the full extended information used in determining the extended system type 
codes. For other processors, the data returned by SYI$_XSID are currently 
undefined. 

Since the value of this register is a longword hexadecimal number, the buffer 
length field in the item descriptor should specify 4 (bytes). 



2.4.2 System Dump Analyzer — New Command 



The Version 4.6 System Dump Analyzer has a new command, SHOW 
CALL —FRAME. This section describes the new command in detail. The 
information in this section updates the VAX/VMS System Dump Analyzer 
Reference Manual. 
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SHOW CALL-FRAME 



Displays the locations and contents of the longwords representing a 
procedure call franne. 



FORMAT 



SHOWCALL_FRAME address 



COMMAND 
PARAMETER 



address 

An expression representing the starting address of the procedure call frame 
you want to display. 



QUALIFIERS 



/NEXT-FP 

Displays the procedure call frame starting at the address stored in the FP 
longword of the last call frame displayed by this command. 



DESCRIPTION 



Whenever a procedure is called using CALLG or CALLS instructions, 
information is stored on the stack of the calling routine in the form of a 
procedure call frame. This call frame contains the following longwords: 

A condition handler address 

A longword containing the stack pointer alignment bits, the register save 
mask for registers RO - Rll, and the saved PSW of the caller 

The saved AP value of the calling routine 

The saved FP value of the calling routine 

The saved PC value (return address) of the calling routine 

One longword for each saved register (RO - Rll) of the caller, specified 
by the register save mask 

The SHOW CALL —FRAME command displays the call frame information 
by interpreting a specified address expression as the beginning address of 
the call frame. If no address expression or options are specified, the default 
address expression for SHOW CALL— FRAME is the longword contained in 
the current process FP register. 

The following example shows the display produced by the SHOW CALL _ 
FRAME command. The display consists of the following sections: 
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Instruction Type 
Call Frame Address 

Call Frame Contents 
Symbols 

Longword Description 
Stack Alignment 
Argument List 



The display indicates which type of instruction, 
either a CALLG or CALLS instruction, generated 
the procedure call frame. 

SDA lists all the virtual addresses that are part of 
the call frame. The call frame addresses are listed 
in a column that increases in increments of 4 bytes 
(one longword). 

SDA lists the contents of the call frame longwords 
in a column next to the call frame addresses. 

SDA attempts to display the contents of the 
longwords in the call frame with the exception 
of the "Mask-PSW" longword, which is not 
symbolized. 

SDA provides a meaningful description of the 
contents of each longword in the context of a 
procedure call frame. 

SDA provides a message describing the number 
of bytes by which the stack pointer was adjusted 
prior to storing the call frame information. 

For CALLS cases, the argument list is displayed by 
virtual address and contents in two columns below 
the stack alignment field. 



All valid procedure call frames have a in bit 28 of the second longword 
of the call frame. If the call frame specified has a 1 in bit 28 of the second 
longword of the call frame, the call frame is invalid and the SDA display 
shows: 

Invalid Call Frame: Bit 28 is Set in "Mask-PSW" Longword 

All valid procedure call frames begin on a longword boundary. If the 
specified address expression does not begin on a longword boundary, the 
call frame is invalid and the SDA display shows: 

Invalid Call Frame: Start Address Not On Longword Boundary 



EXAMPLE 

SDA> SHOW CALL.FRAME 7FFE7D94 
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Call Frame Information 



Call Frame 


Generated by 


CALLS Instruction 


Condition Handl 


er 


7FFE7D94 


00000000 




SP Align Bits = 


■■ 00 


7FFE7D98 


20FC0000 




Saved AP 




7FFE7D9C 


7FFED024 




Saved FP 




7FFE7DA0 


7FFE7DE4 


CLT$GL_KSTKBAS+005E4 


Return PC 




7FFE7DA4 


801A0CEE 


SYSTEM_PRIMITIVES+005E4 


R2 




7FFE7DA8 


7FFE7DD0 


CTL$GL_KSTKBAS+005D0 


R3 




7FFE7DAC 


7FFCCFF8 




R4 




7FFE7DB0 


80443D90 




R5 




7FFE7DB4 


7FFCD0OO 




R6 




7FFE7DB8 


7FFE6400 


MMG$IMGHDRBUF 


R7 




7FFE7DBC 


00000003 




Align Stack by 


Bytes => 






Argument List 




7FFE7DC0 


00000003 








7FFE7DC4 


7FFE7DD0 


CTL$GL_KSTKBAS+005D0 






7FFE7DC8 


00000000 








7FFE7DC8 


00000000 
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2.4.3 Ethernet/802 Device Drivers 

The following sections describe changes to the Ethernet/802 device drivers. 



2.4.3.1 802 Response Packets 

The Ethernet/ 802 device drivers now allow a response packet to be 
transmitted on channels that have the 802 packet format enabled. This is 
accomplished using the WRITE function code and the IO$M —RESPONSE 
modifier. Use of this modifier is validated for those 802 channels that have 
Class I service enabled; the control field value for channels with Class I 
service enabled must be either XID or TEST in order to send a response 
packet. 



2.4.3.2 802 User Supplied Services 

Prior to Version 4.6, the Ethernet/802 device drivers responded to XID 
and TEST command packets. For Version 4.6, all XID and TEST packets 
(command or response) for channels with User Supplied service are not 
responded to by the Ethernet/802 device drivers, but are instead passed to 
the application through READ requests. 

Ethernet/802 device drivers still respond to XID and TEST command packets 
for channels with Class 1 service enabled. 



2.4.3.3 Protocol Type Validation 

The protocol type (NMA$C_PCLI_PTY) parameter is now validated on 
the SETMODE QIO. The validation happens as follows: the Ethemet/802 
device driver takes the low order word of the longword parameter and swaps 
the two bytes. This new word value may not be less than 1501 (05DD 
hexadecimal). If the value is less than 1501, SS$_BADPARAM status is 
returned in the lOSB. 



2.4.4 VAX/VMS System Services Reference Manual — Documentation Change 

The SYI$_CPU item code description for $GETSYI has been revised as 
follows. 

SYI$_CPU 

When SYI$_CPU is specified, $GETSYI returns the general CPU processor 
type of the node. $GETSYI returns this information only for the local VAX 
node. 

Since the processor type is a longword decimal number, the buffer length 
field in the item descriptor should specify 4 (bytes). 

Symbols for the processor types are defined by the $PRDEF macro. 
The following chart gives the current processors and their symbols. For 
information about extended processor type codes, see the description of the 
SYI$_XCPU item code in this section. 

Processor Symbol 

VAX- 11 780, 782, 785 PR$_SID_TYP780 

VAX- 11 750 PR$_SID_TYP750 

VAX- 11 730 PR$_SID_TYP730 

Micro VAX I PR$_SID_TYPUV1 
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Processor Symbol 



MicroVAX II series PR$_SID_TYPUV2 

VAXstation 2000 PR$_SID_TYP410 

VAX 8600, 8650 PR$_SID_TYP790 

VAX 8200, 8300 PR$_SID_TYP8SS 

VAX 8500, 8550, 8700, 8800 PR$_SID_TYP8NN 
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3 Problems, Restrictions, and Notes 



This chapter discusses problems corrected in Version 4.6 of the VAX/VMS 
operating system. It also describes any restrictions that apply to the use of 
the Version 4.6 operating system and contains other information concerning 
the release. 

For ease of reference, the material in this chapter is organized as follows: 

Section 3.1 — General User Information 
Section 3.2 — System Manager Information 
Section 3.3 — Application Programmer Information 
Section 3.4 — System Programmer Information 



3.1 General User Information 



This section describes problems resolved in VAX/VMS Version 4.6, lists 
known restrictions, and contains other information about the release of 
interest to the general user. 



3.1.1 Command Procedures Restriction 



For Version 4.6, all commands, full-line comments, and labels in command 
procedures must be preceded by a dollar sign ( $ ). Although users have 
always been instructed to place a dollar sign before commands and labels, 
pre- Version 4.6 command procedures that omitted dollar signs in front of 
labels did not necessarily stop executing. Version 4.6, however, now treats 
missing dollar signs as illegal syntax; a command procedure that omits a 
dollar sign before a command or label will stop executing. (Continue to omit 
dollar signs from the beginning of data lines.) 



3.1.2 SET HOST/DTE Problems Corrected 



Version 4.6 makes the following corrections to the SET HOST/DTE 
command: 

• SET HOST/DTE/LOG no longer inserts an extra line-feed character in 
log file records. 

• You can now use SET HOST/DTE/LOG with systems that use null 
characters as filler after carriage returns or line feeds. Previous releases 
incorrectly interpreted the end-of-line for these systems. 

• Prior to Version 4.6, the break signal time was variable. For Version 
4.6, the break signal lasts one-half second. As a result, all systems now 
interpret the break signal correctly. 

• When a hang-up terminates a SET HOST/DTE modem line connection, 
SET HOST/DTE terminates with the following message: 

'/.SYSTEM-F-HANGUP. data set hang-up. 
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For more information about the SET HOST/DTE command, see the 
VAX/VMS DCL Dictionary. 



3.1 .3 SET TERMINAL/PASTHRU/PERMANENT Now Works Correctly 

Prior to Version 4.6, if you attempted to set a terminal 
to permanent PASTHRU mode using the command, SET 
TERMINAL/PASTHRU/PERMANENT, the terminal did not remain in 
PASTHRU mode. 

Version 4.6 corrects this problem. If you set a terminal to permanent 
PASTHRU mode, PASTHRU mode continues until the system is rebooted, or 
until this characteristic is changed. 



3.1 .4 DECalc Version 2.2 Problenrr 



Running DECalc V2.2 under Version 4.6 produces the following problem: 
accessing HELP aborts your image. This problem will be fixed in the next 
release of DECalc. 

Until the next release of DECalc, you can rename the appropriate help files 
in SYS$HELP. Attempts to access HELP will then produce a "file not found" 
error message, but will not abort the image. 



3.1 .5 SET QUEUE, START/QUEUE, and INITIALIZE/QUEUE Problem Corrected 

Prior to Version 4.6, DCL commands SET QUEUE, START/QUEUE, 
AND INITIALIZE/QUEUE incorrectly erased queue and job attributes set 
previously with the /BLOCK_LIMIT and /PAGES qualifiers. Version 4.6 
corrects this problem. 



3.1.6 New Hardware Configuration for VAX 8200/8300 Systems — Additions 
to Documentation 

A new hardware configuration exists for VAX 8200/8300 systems. Software 
documentation for the original VAX 8200/8300 hardware configuration is still 
accurate, with the following exceptions: 

• The main cabinet on the new configuration is wider than the original VAX 
8200/8300 cabinet. 

• Diskette drives on the new configuration are oriented horizontally. CSAl 
is the top diskette drive, and CSA2 is the bottom diskette drive. Diskette 
drives on the original configuration are oriented vertically. 

• The processor control panel on the new configuration is located to the 
right of the diskette drives. The processor control panel on the original 
configuration is located under the diskette drives. 

• The new hardware configuration supports a 24-slot backplane; the 
original configuration supports a 12-slot backplane. 
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3.1 .7 VAX/VMS User's Manual — Documentation Correction 

The positions of two figures in the VAX/VMS User's Manual were 
inadvertently reversed in the last release. The figure appearing under 
Appendix CHAR, CHAR.l belongs under Appendix MAIL, MAIL.3.1. The 
figure that appears under Appendix MAIL, MAIL.3.1 belongs under Appendix 
CHAR, CHAR.l. 

3.2 System Manager Information 

This section describes problems resolved in VAX/VMS Version 4.6, lists 
known restrictions, and contains other information about the release of 
interest to the system manager. 



3.2.1 Rebooting a Satellite Node With an Operating System On a Local Disk 

In some circumstances, cluster software reboots satellite nodes automatically. 
Before booting a satellite node, the boot procedures check for the presence 
of an operating system on the node's local disk. If an operating system (for 
example, a Micro VMS system) is found, that system — not the Local Area 
VAXcluster system — is booted. 

If an operating system is installed on a satellite's local disk, one 
of the following measures should be taken before performing any 
operation that causes an automatic reboot — for example, executing 
SYS$SYSTEM:SHUTDOWN.COM with the REBOOT option, or using 
SATELLITE_CONFIG.COM to add that node to the cluster: 

• Rename the directory file ddcu:[000000]SYSO.DIR on the local disk to 
ddcu:[000000]SYSx.DIR (where SYSx is a root other than SYSO or SYSE). 
Then issue the DCL command SET FILE/REMOVE to remove the old 
directory entry for the boot image SYSBOOT.EXE: 

$ RENAME DUAO : [000000] SYSO . DIR DUAO: [000000] SYSl.DIR 
$ SET FILE/REMOVE DUAO : [SYSEXE] SYSBOOT . EXE 

For subsequent reboots of the system from the local disk, enter a 
command in the format B/xOOOOOOO at the console-mode prompt 
(>>>). For example: 

>» B/10000000 

• Disable the local disk. To disable the local disk on MicroVAX II or 
VAXstation II machines, press the READY button so that the light is off. 
(This option is not available if the satellite's local disk is being used for 
paging and swapping.) 
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3.2.2 MONITOR CLUSTER — Misleading I/O Rates for MSCP Served Disks 

The MONITOR CLUSTER command for the MONITOR utility can produce 
misleading I/O rates for MSCP served disks. 

For MSCP served disk I/O, VMS increments the operation count on the 
remote node and the node on which the disk is served. When you issue the 
MONITOR CLUSTER command, MONITOR calculates the displayed I/O 
rate by summing the operation counts for all contributing nodes. As a result, 
MONITOR counts some I/Os more than once; reported I/O rates for MSCP 
served disks might be higher than actual rates. 

To produce more meaningful I/O rates for MSCP served disks, use the 
MONITOR DISK command on the node that serves the disk. For each disk, 
this yields the rate of actual I/Os issued in support of all remote and local 
I/O requests for that disk. 



3.2.3 VAX 8250, VAX 8350, and VAX 8530 Hardware Names Not Recognized 

Several new VAX processors have been introduced since the release of 
VAX/ VMS Version 4.5. The VAX 8250 and VAX 8350 are enhanced systems 
that provide greater performance than the standard VAX 8200 and VAX 
8300. These processors use the KA825 CPU instead of the KA820 CPU; the 
KA825 is 20 percent faster than the KA820. The VAX 8530 is an enhanced 
8500 system with new microcode that provides a 33 percent increase in 
performance. 

VAX/VMS utilities, such as SYSGEN, SDA, SHOW CLUSTER, and the 
GETSYI system service have not yet been modified to recognize the three 
new VAX model numbers. This results in VAX/VMS incorrectly identifying 
the new systems with the older VAX model number. A future release of the 
operating system will correctly identify the new systems. 

For VAX/VMS Version 4.6, you can make the distinction between the VAX 
8200/8300 and the VAX 8250/8350 using the ANALYZE/ERROR utility. 
Each error log entry for the VAX 8250 and 8350 systems correctly identifies 
the CPU type as KA825. You can also use the System Dump Analyzer (SDA) 
to examine the System Identification (SID) register as follows: 

$ ANALYZE/SYSTEM 
SDA> SHOW CRASH 

You can find the SID under the listing of the internal processor registers. The 
VAX 8250/8350 systems will have bit 23 of the SID set to one, while the VAX 
8200/8300 systems will have bit 23 set to zero. 



3.2.4 ASYNCH DECNET Lines Problem — Corrected 



Prior to Version 4.6, VMS attempted to switch terminal lines set for ASYNCH 
DECNET back to terminal mode after power failures. Power failures resulted 
in a useless terminal line or a system crash. 

The power fail logic in the terminal driver now recognizes lines set for 
ASYNCH DECNET and leaves those lines intact. 
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3.2.5 MTHRTL Installation 



Version 4.6 installs the MTHRTL library differently than previous 
releases. Version 4.6 installs MTHRTL using special code in 
SYS$SYSTEM:STARTUP.COM that determines the appropriate library for 
your system. However, if you did not run AUTOGEN at the end of your 
Version 4.6 installation, you might receive messages stating that MTHRTL is 
already installed. Run AUTOGEN to eliminate this problem. 



3.2.6 Future Release Will Enforce Modem Signal Requirements 

A future release of the operating system will enforce modem signal 
requirements, described in Section 8.2.3 of the VAX/VMS I/O User's Reference 
Manual: Part I, before allowing a login. System managers should ensure that 
their host system modems are properly wired and meet the requirements. 



3.2.7 UETP Cluster Test Phase Problems 



The following sections describe problems with the Cluster Test Phase of the 
User Environment Test Package (UETP). 



3.2.7.1 Cluster Test Phase Failures 

The cluster test phase might fail while communicating with cooperating 
test nodes through DECnet when the test nodes exist in a large Local Area 
VAXcluster. The probability of these failures increases if activity is high on 
the test nodes. 

Failures occur most often during the initial startup of the test and at the end 
of the test (during attempts to retrieve error log information). 

A future release will improve the performance of the test on large Local Area 
VAXclusters. Until this improvement is made, DIGITAL recommends that you 
restrict cluster activity to a minimum during testing. 



3.2.7.2 FILLM Quota Problem 

The cluster test phase of UETP produces an exceeded quota error message 
if your Local Area VAXcluster has more than 18 nodes. The message is 
produced during the initial test set up. The problem is caused by a default 
value for the SYSTEST account's FILLM quota that is too low for large 
clusters. (The default value is currently 20.) 

If you are testing Local Area VAXclusters with more than 18 nodes, DIGITAL 
recommends increasing FILLM to a value that is two greater than the total 
number of nodes in your cluster. For example, if your cluster has 20 nodes, 
increase FILLM to 22. 

This problem will be corrected in the next major release of the operating 
system. 
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3.2.8 UETP Problem — VAX Processors With DIGITAL Ethernet LSI to Unibus 
Adapter (DELUA) 

Prior to Version 4.6, the UETP Ethernet device test often produced an error 
report when run on VAX processors with a DELUA configured on the Unibus 
with an H4080 loopback connector. UETP produced the following error 
report: 

•/,UETP-W-TEXT. The process -UETUNAS00_0002- returned a final status of: 
XUETP-E- ABORT. !AS aborted at !7.D 
'/,UETP-W-TEXT . Empty Enet. Start internal loop testing. 

* UNAS_XEB * 

* Error Count = 1 * 

-UETP-E-ABORT, UNAS.XEA aborted at DD-MMM-YYYY HH:MM:SS.CC 
SUETP-I-ENDED. UETUNAS00_0002 ended at DD-MMM-YYYY HH:MM:SS.CC 

This problem has been corrected for Version 4.6. 



3.2.9 EDTSECINI Editor Support 



The EDTSECINI editor provides a TPU-based EDT keypad emulation editor. 
This editor is supplied in both source and compiled format in Version 4.6. 

However, for the next major release, the EVE editor will support the 
EDT keypad; DIGITAL will no longer supply either the EDTSECINl.TPU 
or EDTSECINI.TPU$SECTION files. If you plan to continue using the 
EDTSECINI editor, DIGITAL recommends you save a copy before performing 
the upgrade for the next major release. 



3.2.10 ANALYZE/ERROR_LOG — No Support for TA79 Device 

The Version 4.6 Error Log Utility does not support error log entries for 
the TA79 device. Instead of translating error log entries to text, the utility 
produces output in hexadecimal longword format. 

This problem will be corrected in a future release. 



3.2.11 MSCP Server Problem 



A problem with the MSCP server causes an unexpected system service 
exception bug check. 

The serving system encounters the bug check when you use a foreign device 
that has the device type field in the UCB (UCB$B_DEVTYPE) set to foreign 
device type 1 (#DT$_FD1), and the device is set served to the rest of the 
cluster. 

A future release will correct this problem. Until the problem is corrected, you 
can use another foreign device type designator (#DT$_FD2 through 
#DT$_FD5). 
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3.2.12 Guide to VAX/VMS Software Installation — Documentation Correction 

In the Guide to VAX/VMS Software Installation, Section 7.5.4.1, the FILLM 
quota should be 40, not 20. 



3.2.13 VAX/VMS Network Control Program Reference Manual — 
Documentation Correction 

The VAX/VMS Network Control Program Reference Manual contains an error 
on page NCP-40. 

SERVICE CIRCUIT is listed as a command parameter that can be used with 
the CONNECT NODE command; this is incorrect. Instead of the SERVICE 
CIRCUIT parameter, use the VIA command parameter as follows: 

VIA circuit id 

Specifies the circuit to be used to create the logical link between the host 
node and the target node. The circuit must be an Ethernet circuit. 

In addition, replace the command example with the corrected command 
example that follows: 

NCP> CONNECT NODE RTDEV SERVICE PASSWORD FEFEFEFEFEFEFEFE- 
_ VIA UNA-0 PHYSICAL ADDRESS AA-00-04-00-38-00 



3.2.14 VAX/VMS Network Control Program Reference Manual — 
Documentation Correction 

The following two tables give corrected information for Tables NCP-6 and 
NCP-7 (pages NCP-178 and NCP-179, respectively) in the VAX/VMS Network 
Control Program Reference Manual. 

Table 3-1 lists all VAX PSI management states and substates for DTEs. 
Table 3-2 provides a list of DTE state transitions. 
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Table 3-1 DTE States and Substates 



State Substate 



Meaning 



OFF RUNNING 

SYNCHRONIZING 

UNSYNCHRONIZED 

ON RUNNING 

SYNCHRONIZING 

UNSYNCHRONIZED 
SHUT RUNNING 



SYNCHRONIZING 



UNSYNCHRONIZED 



X.25 level 2 and level 3 software is operational, 
but the DTE is not available for use. Incoming 
calls are cleared. 

X.25 level 2 software is operational, but level 
3 software is not. The DTE is not available for 
use. 

X.25 levels 2 and 3 are not operational, and the 
DTE is not available for use. 

The DTE is available for normal use. 

X.25 level 2 software is operational, level 3 
software is starting up, and the DTE will soon 
be available for use. 

X.25 level 2 software is starting up, and the 
DTE will soon be available for use. 

X.25 levels 2 and 3 are operational, but the 
DTE is not to be used for any new activity; that 
is, all existing virtual circuits will be allowed to 
complete their operations. Incoming calls are 
cleared. 

X.25 level 2 software is operational and level 
3 software is starting up. When the DTE is 
available for use, no circuits can be established. 

X.25 level 2 software is starting up. When 
the DTE is available for use, no circuits can be 
established. 



Table 3-2 DTE State Transitions 



Old State 



New State 



Cause of Change 



OFF-RUNNING ON-RUNNING 



OFF-SYNCHRONIZING 



OFF-UNSYNCHRONIZED 



OFF-UNSYNCHRONIZED ON-UNSYNCHRONIZED 



OFF-SYNCHRONIZING 



OFF-SYNCHRONIZING ON-SYNCHRONIZING 



OFF-RUNNING 



Operator command; SET 
MODULE X25-PROTOCOL 
DTE STATE ON. 

X.25 level 3 software is 
resynchronizing. 

X.25 level 2 software is 
resynchronizing. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE ON. 

X.25 level 2 startup has 
completed. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE ON. 

X.25 level 3 startup has 
completed. 



3-8 



Problems, Restrictions, and Notes 



Table 3-2 (Cont.) DTE State Transitions 



Old State 



New State 



Cause of Change 



OFF-UNSYNCHRONIZED 



ON-RUNNING OFF-RUNNING 



SHUT-RUNNING 



ON-SYNCHRONIZING 



ON-UNSYNCHRONIZED 



ON-UNSYNCHRONIZED OFF-UNSYNCHRONIZED 



SHUT- 
UNSYNCHRONIZED 

ON-SYNCHRONIZING 



ON-SYNCHRONIZING 



SHUT-RUNNING 



OFF-SYNCHRONIZING 



SHUT-SYNCHRONIZING 



ON-RUNNING 



ON-UNSYNCHRONIZED 



OFF-RUNNING 



ON-RUNNING 



X.25 level 2 software is 
resynchronlzlng. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE SHUT. 

X.25 level 3 software is 
resynchronizing. 

X.25 level 2 software is 
resynchronizing. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

X.25 level 2 startup has 
completed. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE SHUT. 

X.25 level 3 startup has 
completed. 

X.25 level 2 software is 
resynchronizing. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE ON 



SHUT- 
UNSYNCHRONIZED 



SHUT-SYNCHRONIZING 

SHUT- 
UNSYNCHRONIZED 

OFF-UNSYNCHRONIZED 



ON-UNSYNCHRONIZED 



X.25 level 3 software is 
resynchronizing. 

X.25 level 2 software is 
resynchronizing. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE OFF. 

Operator command: SET 
MODULE X25-PROTOCOL 
DTE STATE ON. 
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Table 3-2 (Cont.) DTE State Transitions 



Old State New State Cause of Change 

SHUT-SYNCHRONIZING X.25 level 2 startup has 

completed. 

SHUT-SYNCHRONIZING OFF-SYNCHRONIZING Operator command: SET 

MODULE X25-PROTOCOL 
DTE STATE OFF. 

ON-SYNCHRONIZING Operator command: SET 

MODULE X25-PROTOCOL 
DTE STATE ON. 



SHUT-RUNNING X.25 level 3 startup has 

completed. 

SHUT- X.25 level 2 software is 

UNSYNCHRONIZED resynchronizing. 



3.2.1 5 VAX/VMS Networking Manual — Documentation Correction 

The following corrections apply to the VAX/VMS Networking Manual. 

On Page 3-46, in Section 3.5.7 A, the following corrections should be made: 

• In the first sentence, the default value for the RECALL TIMER parameter 
should be 100 seconds. 

• In the third sentence, note that the circuit is placed in the ON-FAILED 
state if an attempt to make an outgoing call causes the system to exceed 
the MAXIMUM RECALLS parameter. 

3.3 Application Programmer Information 



This section describes problems resolved in VAX/VMS Version 4.6, lists 
known restrictions, and contains other information about the release of 
interest to the application programmer. 



3.3.1 VAX Ada Run-Time Library — Corrections 



Version 4.6 includes the following corrections to the VAX Ada Run-Time 
Library that affect VAX Ada programs: 

• Programs can now open files on multiple terminals using package TEXT_ 
lO. In previous versions, this often resulted in access violations in the 
Ada Run-Time Library. 

• Programs that attempt to recover from an error opening a file, where 
the FORM parameter to the OPEN or CREATE procedures is specified, 
now perform correctly. Previous versions produced unexpected errors or 
caused the program to hang. 

• Prior to Version 4.6, tasking programs that opened files on other DECnet 
network nodes, or that opened indexed organization files, sometimes 
received unexpected error messages when the file was used soon after 
being opened; the Ada Run-Time Library did not wait correctly for the 
record stream connect to complete. Version 4.6 corrects this problem. 
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Note that in multitasking applications, the call to the VAX Record 
Management Services (RMS) to open or create a file is always a 
synchronous operation, and all tasking suspends until the RMS operation 
completes. 

You do not have to relink VAX Ada programs to take advantage of these 
corrections. 

Section 3.5 includes a list of fixes for the VAX Ada Run-Time Library. 



3.3.2 VAX PASCAL Run-Time Library — Corrections 



The following subsections describe problems with the VAX PASCAL Run- 
Time Library corrected for Version 4.6. 



3.3.2.1 Invalid String Truncation by DEC and UDEC 

Current VAX PASCAL documentation states that when the length specified 
for the DEC and UDEC built-in routines is too short to hold the converted 
value, the Run-Time Library truncates the resulting string on the left. Prior 
to Version 4.6, however, the Run-Time Library filled the string with asterisks, 
instead of truncating the string. Version 4.6 corrects this problem. The 
Run-Time Library now truncates the string as described in VAX PASCAL 
documentation. 



3.3.2.2 KEY Checks Problem Corrected 

When opening an existing file, the VAX PASCAL OPEN procedure verifies 
that all KEY attributes specified by the user program are consistent in data 
type and size with the actual ISAM keys found in the file. Prior to Version 
4.6, if you skipped a key position with the KEY attribute, the Run-Time 
Library did not verify subsequent keys. For example, if a record contained 
KEY attributes for keys 0, 1, 3, 4, and 5, the Run-Time Library verified keys 
and 1, but did not verify keys 3, 4, and 5. Version 4.6 corrects this problem; 
the Run-Time Library checks all keys for consistency. 



3.3.3 VAX BASIC Run-Time Library — Corrections 



The following subsections describe problems with the VAX BASIC Run-Time 
Library corrected for Version 4.6. 



3.3.3.1 Problem With RMS Bits RAB$V_WAT and RAB$V_TMO Corrected 

Prior to Version 4.6, RMS bits RAB$V_WAT and RAB$V_TMO were cleared 
in the RAB$L_ROP after each FIND or GET was executed. This problem has 
been corrected for Version 4.6. These bits now stay set when applications use 
a USEROPEN to set them. 



3.3.3.2 Run-Time Dimensioned Arrays Problem Corrected 

Releases prior to Version 4.6 had a problem with the deallocation of run- 
time dimensioned arrays. The problem caused a loss of virtual memory, 
which could produce quota exceeded error messages. Version 4.6 corrects this 
problem. 
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3.3.4 VAX SCAN Run-Time Library — Correction to ENDFILE Built-in Function 

Previous versions of the VAX SCAN Run-Time Library had the following 
problem: after you opened a file for input, read to the end of the file, and 
closed the file, the ENDFILE built-in function incorrectly returned the value 
TRUE. 

Version 4.6 corrects this problem. The ENDFILE built-in function always 
returns FALSE if the file is not open. 



3.3.5 DECtalk DTK$ Facility Corrections 



The DTK$ facility consists of routines that control the functions of the 
DECtalk device. Version 4.6 includes the following corrections to the RTL 
DTK$ facility: 

• Prior to Version 4.6, the phone status processing algorithm incorrectly 
processed status messages by interpreting them as keypad input. Version 
4.6 corrects this problem. The Version 4.6 DTK$ facility includes a 
redesigned algorithm that uses two queues to process status messages and 
keypad input separately. 

• Simulation of the AUTOSTOP mode for the DECtalk I device now works 
correctly. 

• Prior to Version 4.6, if you specified the TIMEOUT argument when 
using a DECtalk III device, DTK$DIAL _PHONE ignored the argument. 
Version 4.6 corrects this problem. 

• Prior to Version 4.6, key codes of the form DTK$K_TRM_xxxx were 
incorrect, causing unexpected results. These keypad constants have been 
corrected in Version 4.6 and now function as documented. 

For more information on the RTL DTK$ facility, refer to the VAX/VMS 
Run-Time Library Routines Reference Manual. 



3.3.6 Debugger — Restrictions 



The following subsections describe restrictions that apply to the Version 4.6 
debugger. 



3.3.6.1 SET SCOPE Command 

Before issuing a SET SCOPE command, be sure that the module that 
contains the elements named in the path name has already been set, either 
dynamically by the debugger or by means of a SET MODULE command. Use 
the SHOW MODULE command to determine whether a module is set (that 
is, whether its symbols have been loaded into the run-time symbol table). 



3.3.6.2 SET IMAGE Command 

When you issue a SET IMAGE command and specify a list of images, only 
the last image in the list is set. For example: 



DBG> SET IMAGE A,B,C 



In this example, only image C is set. To set images A, B, and C, issue separate 
SET IMAGE commands for each image. 
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3.3.7 $REWIND and $PUT Problems in Versions 4.4 Through 4.6 

Version 4.4 introduced general support for write sharing of sequential files. 
One aspect of that support was the ability to have multiple writers appending 
to the file, known as shared append. 

While this feature has a number of useful attributes, it has had several 
problems with $REWIND and $PUT operations when RAB$V_TPT has been 
set. These two problems have interacted to cause a set of undesirable and 
changing behaviors. 

In Version 4.4, neither of these operations worked correctly. $REWIND 
would change the current record position to the start of the file, but would 
also reset the shared append state. $PUT with RAB$V_TPT set would 
reposition to end of file if the shared append state were set but correctly 
truncate otherwise. This meant that sequences like the following (in 
FORTRAN) appeared to work, but all WRITE statements after the REWIND 
would not be correctly interlocked against other accessors: 

REWIND (irNIT=l) 
WRITE (1.10) MY.DATA 

Version 4.5 corrected the $REWIND problem. This had the following two 
effects on the previous code fragment: 

• WRITE statements were correctly interlocked because the shared append 
state was still set. 

• The REWIND appeared not to work because the WRITE statement was 
incorrectly repositioning to the current end of file. 

Version 4.6 corrects the problem with $PUT when RAB$V_TPT is set. The 
REWIND now appears to work correctly because the WRITE statement is not 
repositioning to the end of file; $PUT operations against files accessed for 
shared-append only reposition to the actual end of file if the current record 
position is the end of the file. This repositioning is required in order to take 
into account any records that might have been written by other accessors 
between operations. 



3.3.8 VAX/VMS Linker Reference Manual — Documentation Correction 

The following corrections apply to the VAX/VMS Linker Reference Manual. 

On page LINK-113, replace the last paragraph of Section 6.7 with the 
following sentence: 

The linker produces a DST only if the /DEBUG qualifier was specified at link 
time. 

On page LINK-128, replace the first sentence of the fourth paragraph of the 
Description section with the following sentence: 

If you specify /SHAREABLE, you cannot also specify /SYSTEM or 
/TRACEBACK. 

3.4 System Programmer Information 



This section describes problems resolved in VAX/ VMS Version 4.6, lists 
known restrictions, and contains other information about the release of 
interest to the system programmer. 
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3.4.1 Terminal Port Drivers Must Be Recompiled 



Because of a change in the terminal driver CLASS_UNIT_INIT macro, you 
should recompile all terminal port drivers that are not part of the VAX/VMS 
or MicroVMS product. 

The CLASS_UNIT_INIT change prevents the accidental svi^itching of class 
vector tables in the UCB after a power failure; this keeps intact those terminal 
lines that have been switched to an alternate terminal class driver. 



3.4.2 DECnet-VAX Nontransparent Connections — $DASSGN System Service 

Version 4.6 corrects a problem with the $DASSGN system service on DECnet- 
VAX nontransparent connections. 

The VAX/VMS Networking Manual states that issuing the $DASSGN system 
service on a nontransparent DECnet connection deassigns the channel and 
terminates the logical link immediately. This operation is equivalent to using 
SCANCEL followed by $QIO 10$_DEACCESS!10$M_AB0RT. 

Prior to Version 4.6, however, $DASSGN on DECnet-VAX nontransparent 
connections did not work this way. Instead, DECnet issued the $QIO 10$_ 
DEACCESS system service. As a result, remote tasks could not tell whether 
the logical link was terminated because the local task ran down normally, or 
because the local task aborted. 

For Version 4.6, when a local task terminates a logical link by issuing the 
$DASSGN system service, the remote task receives an ABORT status in the 
mailbox. 



3.4.3 IO$M_RESET Modifier in User- Written Drivers 



Prior to Version 4.2, the IO$M_RESET function modifier had the same value 
as the 10$M_INHERL0G modifier, which inhibits error logging. Because the 
IO$M_RESET bit was used only by the DRll-W driver, Version 4.2 changed 
the value of IO$M_RESET to decouple it from the 10$M_1NHERL0G bit. 
Release notes for Version 4.2 documented this change. It is important to note 
that the change also affects user-written drivers that use the IO$M_RESET 
modifier. 

To avoid possible problems, you should concurrently reassemble the 
following: 

• All user- written drivers that use the IO$M —RESET modifier 

• All programs that perform QIOs to user-written drivers that use the 
IO$M_RESET modifier 
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3.4.4 VAX/VMS System Services Reference Manual — Documentation 
Correction 

The $CHANGE_ACL, $FORMAT_ACL, and $PARSE_ACL system services 
have a place-holding nuUarg argument that appears as the last argument in 
the argument list. Following is the correct format of each of these system 
services: 



FORMAT 



SYS$CHANGE_ACL [chan] ,objtyp ,[objnam] Jtmlst 

,[acmode] jnullarg] ,[contxt] 
,[nullarg] 



FORMAT 



SYS$FORMAT_ACL aclent ,[acllen] ,aclstr ,[width] 

,[trmdsc] ,[indent] ,[accnam] 
,[nullarg] 



FORMAT 



SYS$PARSE_ACL aclstr ,aclent ,[errpos] ,[accnam] 

Jnullarg] 

Add the following definition to the end of the argument definition list for the 
$CHANGE_ACL, $FORMAT_ACL, and SPARSE _ACL system services: 

nullarg 

VMS usage: null— arg 

type: longword (unsigned) 

access: read only 

mechanism: by value 

Place-holding argument. This argument is reserved to DIGITAL. 
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3.5 Version 4.6 Fixes 

Following is a sampling of the fixes included in Version 4.6: 
Backup Utility 
Full support of RMS journaling for online and standalone BACKUP. 

Backup Utility 

Standalone BACKUP has been made to lock down its working set so that the 
booted disk csui be removed where two MB or more of memory are available . 
This also means that the disk from which standalone BACKUP was booted can be 
the target of a restore operation. Under standalone BACKUP, the prompt 
delivered at the completion of an operation has also been altered to more 
fully inform the user of the options available. 

Backup Utility 

RSTS BACKUP savesets could not be read by VMS BACKUP. Adding the appropriate 
RSTS attribute codes to VMS BACKUP prevents this problem. 

CLIUTL - SETTERM.B32 (SET TERMINAL DCL Command) 

Add support for the VT300 series of terminals. The command now accepts 
a device type of VT300_Series , and accepts values of one (1), two (2), 
and three (3) for the DEC.CRT qualifier. 

CLIUTL - SHOWTERM.MAR (SHOW TERMINAL DCL Command) 

Enhance the show terminal command to recognize the VT300 series of 
terminals. The utility also recognizes the DEC CRT level 3 capability 
and reports if it is enabled or disabled. 

CWDRIVER Console Winchester Driver 

Two fixes to improve the stability of this driver. The reliability of the 
console disk devices is greatly improved. 

DECnet-VAX 

The outgoing timer used during the connection phase of a logical link 
was incorrectly implemented. Because of sanity checks the maximum 
outgoing timer, with a default retransmit factor of 10, was around 200 
seconds . It has been modified so that the 200 seconds is only the 
threshold for receiving the Connect Acknowledge message not the 
confirmation or rejection of the request. 

DECnet-VAX 

During establishment of a logical link a timing problem resulted in 
the Connect Acknowledge (CA) message not being sent. This resulted in 
additional Connect Initiate (CI) message transmission and extra resource 
utilization, nonpaged pool and processing. The timing problem has been 
resolved and optimization checks were added to eliminate unnecessary 
resource consumption. 

DECnet-VAX 

During the establishment of a logical link duplicate Connect Initiate (CI) 
messages were improperly handled. Duplicate CI messages are a result of 
timing or a dropped Connect Acknowledge (CA) message . A new mechanism was 
added to properly handle this condition. 
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Differences Utility 

The file compare utility no longer loops indefinitely if the nvunber of 
differences encountered was non-zero and the /MAXIMUM_DIFFERENCES qualifier 
specified a value of (zero) . 

DIRECTORY 

Subtotal lines will now be correctly reported for a directory listing 
performed on multiple subdirectories (i.e. using search lists and wildcarding) 

DWBUA - BI to XJNIBUS Adapter 

VMS now generates an error log entry, instead of a crash, when the DWBUA 
encounters an invalid map register reference. 

LAT 

When using application ports, LTDRIVER is no longer sensitive to 
lower case teirminal server node and port names. 

LAT 

After a powerfail recovery, application ports are usable without 
having to do a STOP NODE command from LATCP. 

LAT 

After a LOGOUT/NOHANGUP , the UCB is not set offline. 

LIB$DECODE_FAULT 

Correct processing of short floating literals in the instruction stream. 

MGRMENU.COM - MicroVMS Manager Menu 

MGRMENU.COM is a new command procedure that is used to point to the command 
procedures distributed with MicroVMS that were created to help the system 
manager with system management tasks (e.g. ADDUSER.COM. BACKUSER.COM, etc.). 
On MicroVMS, this new command procedure is called when the system manager 
logs into the SYSTEM account. 

Monitor Utility 

In a Multi-node request for the System Statistics class, the limits 
for the Free and Modified lists are now set properly for each node. 

Error message output has been Improved. 

Computation of the SCS class kilobyte items has been corrected. 

Mount Utility 

Fix device count problem when mounting a multi-volume tape set on 
a single device. 

Mount Utility 

Fix problem when mounting a volume with a bad bitmap file. 

Mount Utility 

Suppress erroneous rebuild message when mounting a volume on a device 
that is hardware write-locked. 
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NCP UTILITY 

The information displayed by the NCP SHOW CIRCUIT SUMMARY command has 
changed. This command used to display all adjacent nodes (including 
endnodes) over the given circuit. The command now displays only adjacent 
routing nodes . 

Record Management Services 

Generic match of descending string keys will no longer return an erroneous 
RMS$_KSZ error. 

Record Management Services 

Adding records to an indexed file causing a bucket split in the middle of a 
large duplicate chain will no longer cause file corruptions. 

Record Management Services 

ENQLM could be lost through a number of means. Specifically: 

- Modifying a currently held record lock 

- A random $PUT operation after a $GET on a shared sequential 
file. 

- $PUT or $GET/$FIND operations against a sequential file with 
the FAB$V_BLK attribute when opened shared. 

The record locks are now correctly maintained and no ENQLM loss occurs. 

Record Management Services 

If a shared sequential file was randomly accessed an incorrect record 
would be locked. This has now been corrected. 

Record Management Services 

Errors which occurred during post-processing of shared sequential $GET 
or $PUT operations would fail to return an error status. This status is 
now returned. 

Record Management Services 

$PUT operations with the RAB$V_TPT flag set would incorrectly reposition 
to the current end-of-file if the file had been accessed for shared 
append operations. This repositioning no longer occurs. 

Record Management Services 

The $XABFHC now correctly fills in the current end of file position for 
sequential files opened shared. Previously the end of file position from 
the last $FLUSH or $CLOSE was returned. 

Record Management Services 

A problem involving $PUT and RAB$V_TPT set has been fixed. Prior to Version 
4.6, $PUT with RAB$V_TPT set would reposition to the end of file if the 
shared append state were set. For Version 4.6, $PUT operations 
against files accessed for shared append only reposition to the actual end of 
file if the current record position is already at end-of-file. This 
repositioning is required in order to take into account any records that may 
have been written by other accessors between operations. 

REMACP 

If you defined a logical name "RT" on your VAX/VMS V4.5 system, starting REMACP 
would crash the system. REMACP now uses "_RT" internally as the remote terminal 
device name to avoid conflicts. 
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REMACP 

If you set the SYSGEN parameters MAXBUF or RJOBLIM to values significantly 
higher than their V4.5 defaults, REMACP would exit with a page file quota error 
as it started. RTTLOAD now calculates a reasonable page file quota for REMACP, 
based on RJOBLIM and MAXBUF. 

RTPAD - RTDTE.B32 (SET HOST/DTE DCL command) 

Rewrite the logging code to correctly handle null lines, fill characters 
between the Carriage Return <CR> Line Feed <LF> sequence, and to not 
include an extra <LF> character in the log file. Change send break 
routine to wait at least .250 seconds before clearing the break signal. 
Abort the program with a reason of SS$_HANGUP if the communications line 
is set to modem and Carrier Detect is lost . 

RTPAD - DTE.DMCL.MAR 

Add new auto dial code to support modems that support the Digital Modem 
Command Language. 

SET HOST 

If you SET HOST to a RSTS system, VMS line editing and command recall will 
continue to work, even at the RSTS system prompt. These functions did not 
work with VAX/VMS Versions 4.2 through 4.5. 

SET HOST 

If you are SET HOST into a VAX/VMS V4.5 (or earlier) system, and you set new 
terminal characteristics, those new settings would be lost if you ran an 
image which set a CTRL/C or CTRL/Y AST. This has been fixed. 

SET HOST 

If you are SET HOST into a VAX/VMS V4.5 (or earlier) system, a single NULL 
termination character (CTRL/Space) would not be transmitted. This is fixed. 

SET HOST 

Remote terminals on VAX/VMS V4.4 and V4.5 systems would often show large 
error counts due to a protocol error. These errors have been eliminated. 

SET HOST 

QIOs on remote terminals did not always return the same lOSB values for 
escape sequences as on local terminals. This has been fixed. 

Structure Level 1 File System (FllAACP) 

Handling of the access control list functions has been changed so that 
attempts at access control list manipulation no longer return "invalid 
attribute control list" errors, but are ignored. 

Structure Level 2 File System (FllBXQP) 

Error handling has been corrected so that certain errors (for example, 
errors accessing the previously existing version of a file on a create) 
no longer result in the loss of non-paged pool. 

Structure Level 2 File System (FllBXQP) 

Processing of file access audits has been corrected so that a file 
delete resulting in multiple audit messages executes correctly, 
and no longer causes spurious errors . 

Structure Level 2 File System (Extended QIO Processor) (FllBXQP) 
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If a node in a cluster crashed before it had chance to pass updated 
information to other members of the cluster, the index file (INDEXF.SYS) 
could be corrupted and data lost. This has been fixed so that updated 
information is always used, regardless of the state transitions of other 
machines . 

Structure Level 2 File System (Extended QIO Processor) (FllBXQP) 

The error message "NOTVOLSET, not a volume set" could be reported under 
bogus circumstances. This has been corrected. 

SYSL0A8NN 8800/8700/8550/8530/8500 CPU Support 

Many fixes to the logging of CPU and adapter errors. The most notable fix 
is that the NMI silo now contains the first 64 non-zero longwords, rather than 
the first 64. Also change log entry type for UBA errors from EMB$K UBA to 
EMB$K_BIADPERR. 

TPU 

TPU will no longer issue a NODEFINITION message for the first printing key 
which has a SHIFT ed definition. 

TTDRVR - TTYCHARI.MAR 

Correct the autobaud detection code to initiate a login only when a 
valid terminator is seen. This corrects the problem where powering up a 
VT102 terminal would generate a login failure. 

TTDRVR - TTYSUB.MAR 

Fix cancel code to correctly preserve the PASTHRU characteristic. If a 
terminal was set to PASTHRU mode permanently and all channels to the 
terminal were deassigned the driver would be treated as being in 
NOPASTHU mode. SHOW TERMINAL would indicate that the terminal was set 
to PASTHRU mode. 

TTDRVR - YCDRIVER 

Fix YC$ABORT to correctly cancel pending write operations. This 
corrects cases where a CTRL/S followed by a CTRL/0 would output random 
data. 

UETP 

Added support for the RRD50 CD reader. 

VAX Ada Run-Time Library 

Correctly release virtual memory when an OPEN or CREATE fails 
and a form string is supplied. 

VAX Ada Run- Time Library 

Wait for RMS connect operation to complete in multitasking program. 

VAX Ada Run-Time Library 

Correct errors in conversion of integers to based literals. 

VAX Ada Run-Time Library 

Correct errors in ENUMERATION. 10. GET when reading a blank string. 

VAX Ada Run- Time Library 
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Correctly handle page terminators in files with FORTRAN carriage control, 
and write form-feeds as page terminators to PRN carriage control files. 

VAX Ada Run- Time Library 

Correctly handle use of package TEXT.IO when two or more terminals are opened 
as files. 

VAX Ada Run-Time Library 

When an Ada program is receiving ASTs at a very high rate, or for a 
very long time, a sporadic Reserved Operand Fault or Access Violation 
will no longer occur. 

VAX MATH (MTH$) Run-Time Library 

A misplaced JSB prevented proper underflow handling. The problem has been 
corrected . 

VMS Run-Time Library, LIB$ Facility 

LIB$RENAME_FILE now passes the correct address of the size of the virtual memory 
to be allocated or deallocated by the LIB$VM routines. Before, the address 
passed was corrupted. 

VMSLIB - STARDEFZ 

Add the terminal type TT$VT300_SERIES , and add the TT2$x_DECCRT3 
characteristics bit . 
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Part II LAT/VMS Management Guide 

Part II contains the LAT/VMS Management Guide. 



Functions of LAT/ VMS Software on a VMS 
System 



LAT/VMS functions in an Ethernet local area network (LAN) environment. 
The LAT/VMS software is part of your VMS operating system. LAT/VMS 
permits your VMS system and a server to exchange data. In this manual, 
remote printers are used as examples to describe how application programs 
access remote devices on a terminal server. LAT/VMS also has the features 
required for your VMS system to function as a node that accepts connections 
requested by server users. 

4.1 Local Area Transport (LAT) Protocol 

LAT is an Ethernet-based protocol which makes use of unique Ethernet 
features to provide an efficient means of logically connecting servers to one 
or more LAT nodes on the same Ethernet. LAT does not use DECnet to 
transport messages, but it can coexist on a network with DECnet. A typical 
LAT network is shown in Figure 4-1 . 
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Figure 4—1 A Typical LAT Networic 
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Servers and DIGITAL operating systems implement the LAT protocol for 
communications between servers and host systems. The LAT/VMS software 
implements LAT on your VMS system. 



4.2 LAT Print Symbiont 



The LAT/VMS software includes the LATSYM print symbiont. LATSYM 
differs from the VMS print symbiont, as it allows the LAT port driver to 
dynamically create and terminate connections to remote printers on servers. 
LATSYM uses the same I/O function code modifiers that are provided for 
application programs (see Chapter 7). 

Note: You cannot use the standard VMS print symbiont for LAT connections. 
See Chapter 6 for the configurations required to set up your service node 
for remote printers. 
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4.3 



LAT Definitions 



A LAT node runs software that implements the LAT protocoL There are two 
types of LAT nodes: a VAX/VMS system that offers resources to terminal 
server users and servers that offer resources over the LAN. 



4.3.1 Service Nodes 



4.3.2 Groups 



4.3.3 Services 



4.3.4 Sessions 



A service node is a LAT node that offers services to server users. In this 
manual, service node refers to a VAX/VMS computer system running the 
LAT software. Terminal servers that function as a service node also allow 
users to connect to services offered over the LAN (see Section 4.4.6). 



Groups are used to partition a LAT network among LAT/VMS nodes and 
servers. A server can establish a logical connection with the LAT/VMS nodes 
that share a common group with the server. Nodes and servers that are 
partitioned in this fashion must be on the same Ethernet. See Chapter 5 for 
information about setting up groups for your service node. 



A service is a resource offered by service nodes on the LAN. You can have 
up to eight services defined for your node. Each service offers all of the 
resources of your node even though each service has a different service name. 
Services are announced by all service nodes on the LAN. Servers accept 
service announcements from service nodes that share a common group with 
the server. 



Sessions are logical connections from devices at terminal server ports to 
services. Each terminal on a server appears as if it were connected directly to 
a service it is using. During a session, the actions of the terminal server are 
transparent to users. LAT server software enables a user to maintain several 
sessions at once, allowing the user to move quickly between sessions. Refer 
to the server Management Guide or Operations Guide. 



4.4 Server/Service Node Communications 

Service node and server communications involve a number of concepts. 
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4.4.1 Virtual Circuits 



The exchange of data on a LAT network relies on the use of a virtual circuit 
to create sessions between a server and a service node. A virtual circuit is 
an independent, logical path that is used for exchanging data between two 
nodes. LAT virtual circuits are multiplexed over a single physical circuit. The 
physical circuit hardware includes the server's network interface, the network 
hardware, and the service node's network interface. 

To establish server/service node communications, the server determines 
whether a virtual circuit exists to the service node offering a service or 
requesting a remote printer connection. If no virtual circuit between the 
nodes currently exists, the server establishes one. 

Once started, a virtual circuit between two nodes lasts as long as sessions 
are active. During this period, this single virtual circuit channels all the 
data exchanged by all sessions between the two nodes. Thus, all concurrent 
connections between a pair of LAT nodes — whether requested by a terminal 
user on a server or by an application program on a service node — share one 
virtual circuit. A LAT/VMS node can have concurrent virtual circuits to as 
many as 255 nodes. 

Virtual circuit messages are sent automatically by the server at regular 
intervals. The interval between transmissions is determined by a circuit 
timer, which the server maintains. The server holds the requests-to-send 
data made by server ports by buffering input at a port until the circuit timer 
expires. The server then transmits all data that is pending from all of its ports 
in one virtual circuit message. If the server is maintaining multiple virtual 
circuits, the server builds one message per circuit and sends out multiple 
virtual circuit messages. Each message contains data for only those ports 
connected to the node at the other end of the circuit. 



4.4.2 Multicast Service Announcements 



A service node periodically sends a multicast message that contains 
information about the node and any services it offers to terminal servers. 
The multicast message contains a node name, group designations, service 
names, and service ratings. Using information received in these multicast 
messages, each server builds up a directory of service node names and service 
names. However, service nodes do not maintain an equivalent directory. For 
example, when an application program requires the use of a remote printer, 
the service node multicasts a request for information about the node offering 
that printer. 

The service announcement includes identification strings for the service 
node and services offered by the node. An identification string is a short 
ASCII string that you specify when setting up your service node or creating a 
service. 



Functions of LAT/VMS Software on a VMS System 



4.4.3 Load Balancing and Service Rating 



Servers provide a load-balancing feature that allows them to automatically 
establish connections to a service on the least busy service node that offers 
the service. Load balancing is especially useful for VAXcluster management, 
though it is not limited to clusters. 

Load balancing depends upon service ratings provided by the service nodes. 
The service rating value for a service is calculated dynamically by each service 
node that offers it. The node announces the rating value over the LAN as 
part of the service announcement message. The service rating is based on the 
overall level of activity of the node and the processor type. A high level of 
system activity gives a low service rating and hence inhibits new connections. 
The use of service ratings allows load balancing among nodes offering the 
same services. Servers compare the service rating values provided by all 
service nodes offering a requested service, and connect to the node with the 
best (highest) rating. 

Service names provide a mechanism for distributing user demand on 
VAXcluster nodes. By creating an identical service name on two or more 
service nodes, you enable servers to balance the load on the service nodes in 
the VAXcluster that offer the common service. 



4.4.4 Automatic Failover 



In addition to load balancing, servers provide automatic failover when 
multiple service nodes offer a common service. Automatic failover is a failure- 
recovery function that takes over if a session is disrupted because a service 
node becomes unavailable. After such a failure, the server automatically 
searches for other service nodes that offer the same service. The server 
attempts to connect to the service on an alternative node with the highest 
service rating. In the case of VAXclusters, automatic failover provides a 
reliable terminal connection to a reliable service. Automatic failover allows 
users to log in again and to continue working in the event of a node failure. 



4.4.5 Remote Printer Device 



A printer connected to a server is called a remote printer. A remote printer 
must be an asynchronous ASCII character device. A remote printer on a 
server can be shared by all LAT/VMS service nodes, which makes it possible 
to optimize the use of remote printers. If a server with a printer is located in 
an office, users of terminals on that server can conveniently obtain hard-copy 
listings for their printing tasks. 

Application programs on a service node can request a connection to a remote 
device. A request by an application program for a connection to a server 
is called a host-initiated request. Host-initiated requests by an application 
program identify the targeted remote device. The identification is the server 
name and the port ID or a service offered at that port. Each remote device is 
mapped to a logical device (applications port) on the service node. 

When an application program attempts to access the applications port, the 
LAT port driver (LTDRIVER) sends a host-initiated request over the LAN to 
the server. The LAT port driver is contained in the LAT/VMS software. The 
server then makes the connection. To guarantee that all the service nodes 
obtain reasonable access to each remote device, a server manager can enable 
a first-in-first-out (FIFO) queue on a server. A queued or nonqueued request 
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is accepted by the server if the remote port is free. If the remote port is busy 
and queuing is enabled on the server, then a remote request is queued. 



4.4.6 Servers as Service Nodes 



In addition to offering printer support, some servers also operate as LAT 
service nodes. In functioning as a service node, a server advertises services, 
for example, a remote printer or dial-out modem, to its own port users or to 
other servers. When one of these services is requested, the server completes 
the logical connection to the service. 

Note that not all servers offer printer support or are capable of functioning as 
LAT service nodes. Refer to the Software Product Description of each server to 
determine its capabilities. 

Note: The LAT port driver only accepts connections through one Ethernet 
adapter on each service node. 



4.5 LAT/VMS Files 



The files that constitute the LAT/VMS software are installed in the following 
directories: 

SYS$SYSTEM directory 

LTDRIVER.EXE 

LATCP.EXE 

LATSYM.EXE 

SYS$MANAGER directory 

LTLOAD.COM 

SYS$HELP directory 

LATCP.HLB 
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As a LAT service node manager, you are responsible for several broadly 
defined tasks, which include: 

Setting up the characteristics of your service node (Section 5.4). 

Managing services offered by your service node (Section 5.5). 

Setting up remote devices for your service node (Chapter 6). 

Editing your system startup files (Section 5.7). 

Starting the LAT software (Section 5.8.4). 

Stopping the LAT software (Section 5.8.5). 

This chapter discusses setting up characteristics of your service node and 
managing services offered by your service node. 



5.1 Management Overview 



The LTLOAD command file for managing your LAT service node is part 
of the LAT/VMS software provided in the SYS$MANAGER account. 
LTL0AD.COM contains LATCP commands. The characteristics set up 
by the LTLOAD.COM file are your LAT default characteristics. To set 
up the characteristics to customize your service node and services, edit 
LTLOAD.COM. 



5.2 Example of a LAT Network 



A sample LAT network is shown in Figure 5-1. This figure is referred to 
throughout this chapter. 

The nodes DUKE and EARL, which are in a VAXcluster, can make host- 
initiated requests for any of the remote printers connected to the LATl 
server. These nodes share the same mass storage devices and offer a common 
cluster LAT service called SALES. The LAT terminal server, LATl, has 
interactive terminals represented by the letter T. The printers on this server 
are represented by the letter P or by a specific printer name. LQP02 and 
LAIOO are printers. 
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Figure 5-1 Service Nodes, Remote Printers, and Services 
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The LTLOAD.COM File 



The LTLOAD.COM file contains commands that perform many of the 
basic LAT management functions needed at system startup time. The 
LTLOAD.COM file: 

Loads the LAT port driver using a SYSGEN command 

Sets up your LAT service node characteristics 

Creates services for your service node 

Sets up some of the remote printer characteristics 

Starts the LAT port driver 

To tailor the service node characteristics of your service node, edit the 
LTLOAD.COM file. 
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After the LTLOAD.COM file is altered for your service node, enter 
a command in your system startup file to automatically execute the 
LTLOAD.COM file upon system startup. Section 5.7 explains how to do 
this. 

Note that if DECnet is going to be started on your node, you must start 
DECnet before starting the LAT port driver. 

The LTLOAD.COM default file that you get with your LAT software is shown 
in Example 5-1. This file applies default node and service characteristics to 
your system. To override the defaults, you can pass the characteristics as 
parameters in the command line. This method is especially useful if you have 
multiple nodes in a VAXcluster with the same LAT characteristics. 

The LTLOAD.COM file accepts the following command line parameters: 

• PI specifies the service name. 

• P2— P4 specifies up to three valid qualifiers for the LATCP SET NODE 
command, such as /ENABLE=(25,26). 

You can also override the default parameters by editing the LTL0AD.COM 
file and specifying the node and service characteristics that you desire. 

If you execute LTLOAD.COM vdthout making changes or passing parameters, 
the default characteristics are assigned to your node. 

The CREATE PORT and SET PORT commands in LTLOAD.COM set up 
a remote printer for your service node. These commands are explained in 
Chapter 6. 

The LTLOAD.COM file, shown in Example 5-2, refers to the service nodes, 
server, and printers in Figure 5-1. Notice that the PI and P2 — P4 parameters 
are not specified in this example. The commands in this file are explained in 
the following sections of this chapter. 
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Example 5-1 LTL0AD.COM Default File 



$ ! This conunaind procedure starts up the LAT protocol 

$ ! and configures applications ports for remote printer use. 

$ 

$ RUN SYS$SYSTEM:SYSGEN 

CONNECT LTAO: /NOADAPTER 

$ 

$ ! Invoke LATCP 

$ 

$ LCP := $LATCP 

The following commands set up the LAT service with the default name 
SYS$NODE and default ident SYS$ANNOUNCE . If you do not want the 
default SYS$NODE node neune applied, specify a service name for the first 
parameter in the command line. You can use up to three parameters 
(P2 — P4) to specify additional characteristics, such as group 
codes, for your node. 

$ LCP SET NODE /IDENT 'P2' 'P3' 'P4' /NOLOG 
$ LCP CREATE SERVICE 'PI" /IDENT /NOLOG 
$ ! 
$ RUN SYS$SYSTEM: LATCP 

Set up the applications ports that will support remote printer 
access. 



Create the applications ports . 

CREATE PORT LTAl : /NOLOG 
CREATE PORT LTA2: /NOLOG 

Maps applications port(s) to a specific port(s) on the server. 

SET PORT LTAl: /APPLICATION /N0DE=SERVER_1 /P0RT=P0RT_5 
SET PORT LTA2: /APPLICATION /N0DE=SERVER_1 /PORT=LQ_PRINTER 

Start the node. 

START NODE 
EXIT 
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Example 5-2 Example of LAT Service Node Startup Command File 



$ ! This command procedure starts up the LAT protocol 

$ ! and configures applications ports lor remote printer use. 

$ 

$ RUN SYS$SYSTEM : SYSGEN 

CONNECT LTAO: /NOADAPTER 

$ 

$ ! Invoke LATCP 

$ 

$ RUN SYS$SYSTEM: LATCP 

Set up the node name DUKE with the announcement "A member of 
the SALES VAXcluster" . Enable groups 1 and 4 . and set the 
multicast timer. 



SET NODE DUKE /IDENT="A member of the SALES VAXcluster" /NOLOG 
SET NODE DUKE /ENABLE=(1.4) /MULTICAST_TIMEH=70 /NOLOG 

Create services DUKE and SALES. 

CREATE SERVICE DUKE /IDENT="DUKE Interactive Service" /NOLOG 
CREATE SERVICE SALES /IDENT="SALES Service" /NOLOG 

Set up the applications ports that will support remote printer 
access. 

Create the applications ports. 

CREATE PORT LTA321: /NOLOG 
CREATE PORT LTA322: /NOLOG 

Maps applications port(s) to a specific portCs) on the terminal server. 

SET PORT LTA321: /APPLICATION /NODE=LATi /P0RT=P0RT_7 
SET PORT LTA322: /APPLICATION /N0DE=LAT1 /SERVICE=PRINTER 

Start the node. 

START NODE 
EXIT 



5.4 Setting Service Node Characteristics 



As the service node manager, you need to set up the following service node 
characteristics: 

• Node name 

• Node identification announcement 

• LAT network groups 

• Multicast timer 
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5.4.1 Node Name 



All LAT service nodes must have a node name that is unique within the LAT 
network. 

If the service node is part of a DECnet network, the LAT service node name 
should be the same as the DECnet node name. The DECnet node name has 
to be unique within the same logical Ethernet and must be unique within 
the entire DECnet network. On DECnet nodes, the LAT node name is given 
the DECnet node name, SYS$NODE, by default. If the service node is not 
running DECnet, but will be in the future, then it is recommended that you 
define SYS$NODE before using the LTL0AD.COM file and LATCP. 

The LAT node name can be from 1 to 16 ASCII characters long. Legitimate 
characters are described in Appendix A. 

The following LATCP command assigns the name DUKE to your service 
node: 

SET NODE DUKE 

The node name default is the translation of the SYS$NODE logical name. 



5.4.2 Node Identification Announcement 



The node identification announcement is a description for your node. The 
announcement is advertised to server users in multicast messages that your 
service node processes once the LAT port driver is started. The announcement 
can be a string of up to 64 ASCII characters in length, that cannot begin with 
an ampersand ( & ). Nonprintable characters are translated as spaces. Enclose 
the string in quotation marks (""). 

The following command specifies an identification announcement for node 
DUKE: 

SET NODE DUKE /IDENT="A member of the SALES VAXcluster" 

If you do not specify a node identification announcement, the default 
is the string for SYS$ANNOUNCE. If a string was not specified 
for SYS$ANNOUNCE and you do not specify a node identification 
announcement string, then only your service node name is sent in the 
multicast messages. 



5.4.3 LAT Network Groups 



Groups are used to partition the LAT network into logical subdivisions. 
Groups are set up by the network manager, system managers, and server 
managers. Controlling groups allow you to restrict message traffic between 
servers and service nodes. To establish a connection, the server requesting a 
connection to your LAT service node must share at least one group with your 
node. 

When messages are received by a server from service nodes that are not in 
any group enabled on the server, these messages are ignored. Groups help 
manage the size of the server's databases by limiting the number of service 
nodes for which the server keeps information. Groups are not intended as a 
security mechanism. 
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The following LATCP command enables groups 1 and 4 for service node 
DUKE: 

SET NODE DUKE /ENABLE=(1 ,4) 

Group is enabled by default for all service nodes and servers. If you do not 
want group enabled, you must specifically disable it using the /DISABLE 
qualifier. 



5.4.4 Multicast Timer 



The multicast timer determines the time between the multicast messages sent 
by your service node. The minimum value is 10 seconds; the maximum is 
255 seconds. 

The default value of 60 seconds is usually adequate. If you assign a large 
value to the multicast timer, network overhead is mininuzed because multicast 
messages are sent less frequently. However, terminal server users have to 
wait longer for services to become available after the server is rebooted, or 
after recovering from a network problem. In addition, the service rating used 
in load balancing by the server (see Chapter 4) is provided in these messages. 
Infrequent multicasts by the service node can affect load balancing by the 
server. 

If you assign a small value to the multicast timer, more network resources are 
consumed since the server must adjust its LAT database and process multicast 
messages more frequently. 

Note that whenever you change a characteristic for your node, the multicast 
messages are immediately sent out over the network to announce that change. 

The following LATCP command sets the multicast timer for node DUKE to 70 
seconds: 

SET NODE DUKE /MULTICAST_TIMER=70 

This command causes multicast messages for node DUKE to be sent out on 
the network every 70 seconds. 



5.5 Managing Services 



You can create up to eight services on your service node. All the functions 
and features offered by your VMS system are included for each service. 

Use the CREATE SERVICE command to specify the following characteristics 
for your service node: 

• Service names 

• Service announcements 

• Service ratings 
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5.5.1 Service Names 



Service names can be up to 16 ASCII characters long. Legitimate characters 
are described in Appendix A. Users generally request access to the resources 
of a service node by using a service name rather than the LAT node name. 

Several service nodes can share one service name. A shared service name 
is especially useful in VAXclusters. It allows the cluster to be known by a 
cluster name instead of individual node names. 

The name of each service and the rating of the service node (see Chapter 4) 
are contained in the multicast messages sent by your node. The service name 
is displayed to server users when they enter a SHOW SERVICES command at 
the server's local prompt. 

The following LATCP command assigns the service name SALES to node 
DUKE, assuming that you issue the command on node DUKE: 

CREATE SERVICE SALES 

If you do not specify a service name in the command line, the default service 
name is assigned. The default is the translation of the SYS$NODE logical 
name. You can create only one service with the default service name. You 
must specify a unique service name for each service that you create. 



5.5.2 Service Announcements 



The service announcement is a description for your service. The 
announcement is advertised to server users in the multicast messages. The 
announcement is a string of up to 64 ASCII characters long that cannot begin 
with an ampersand (&). Nonprintable characters are translated as spaces. 
Enclose the string in quotation marks (""). 

The following LATCP command specifies an announcement string for the 
service SALES: 

CREATE SERVICE SALES /IDEKT="SALES Service" 

The default for the service announcement is the value for SYS$ ANNOUNCE. 



5.5.3 Service Ratings 



At every multicast message interval, the LAT port driver software generates a 
dynamic service rating for services that it offers on the LAT network. Servers 
use this service rating for load balancing. Dynamic service ratings vary from 
255 (highly available to users) to (not available to users). 

Normally, these dynamically generated service ratings are adequate and allow 
efficient load balancing on the LAT network. However, you have the option 
of overriding the dynamic values by assigning a static service rating. If the 
dynamic rating on any alternate node drops below the specified static rating, 
a static service rating value can be used to direct server users temporarily 
away from or toward a particular node. Note that load balancing does not 
take place when static ratings are used on all nodes. 

To specify a rating of 195 for the service SALES, use the following command: 

CREATE SERVICE SALES /STATIC_RATING=195 

This command disables the dynamic service rating generated by the LAT port 
driver. 
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5.6 Advertising Services 



All services that you create for your service node are advertised in the 
multicast messages processed by your node. Advertisement of the services 
begins when the LAT port driver has been started using the LATCP START 
NODE command: 



START NODE 



If new services are added while the driver is running, the multicast messages 
are sent out immediately over the network to announce the new services. 



5.7 Editing Your System Startup Files 



To configure your service node automatically upon system startup, change 
your startup procedure to invoke the LTLOAD.COM command file. This 
command file is located in the SYS$MANAGER directory. This section 
describes the procedures for invoking the LTLOAD.COM file on individual 
service nodes and on VAXcluster nodes. 



5.7.1 Invoking the LTL0AD.COM File on Individual Nodes 



To invoke the LTLOAD.COM file, put a command line in your startup 
procedure. Where you put the command line depends on whether your node 
is running DECnet. If DECnet is present, insert this command after invoking 
STARTNET.COM. If DECnet is not present, execute the LTLOAD.COM file 
when the node is ready to accept interactive users. The command is: 

$ aSYS$MANAGER:LTLOAD.CQM 

You can also create a command file using the commands necessary to set up 
and start print queues for remote printers. To configure the remote printers 
automatically upon system startup, change your startup procedure to include 
this file, as described in Chapter 6. 



5.7.2 Invoking the LTL0AD.COM File on VAXcluster Nodes 



VAXclusters can have LAT nodes that have identical LAT configurations. In 
this case, use a common LTLOAD.COM file and pass the cluster service name 
as a command line parameter when LTL0AD.COM is invoked. Edit the 
COMMON_STARTUP.COM file, and include a command line similar to the 
one in the following example after DECnet has been started: 

$ eSYSSCOMMON: [SYSMGRILTL0AD.COM SALES "/ENABLE=(24,25)" 

This command passes the cluster service name, SALES, to all nodes in the 
cluster and enables groups 24 and 25. 

VAXclusters can also have LAT nodes that have different LAT configurations, 
such as the applications ports. In this case, edit a node-specific 
SYSTARTUP.COM file to invoke LTL0AD.COM after DECnet has been 
started, as shown in Example 5-3. 
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Example 5-3 Invoking LTL0AD.COM on a VAXcluster Node 



This is a site specific startup command procedure for node DUKE 
on the SALES VAXcluster. 



$ 
$ 
$ 

Invoke the common system startup procedure 
$ 

$ aSYS$COMMON : [SYSMGR] COMMON_STARTUP . COM 
$ ! 

$ ! Start up DECnet 
$ ! 

$ 8SYS$MANAGER: STARTNET.COM 
$ ! 

$ ! Define the Login Announcement 
$ ! 
$ DEFINE/SYS/EXEC SYS$ANNOUNCE - 

"DUKE-A Member of the Sales VAXcluster" 
$ ! 

$ ! Start LAT 
$ ! 

$ 9SYS$MANAGER: LTL0AD.COM 
$ ! 



5.8 Interactive Use of LATCP 



To modify any of the node or service characteristics, enter LATCP commands 
interactively. Only one user at a time can run LATCP. (To invoke LATCP, 
you must have CMKRNL privileges.) 

Edit the LTL0AD.COM file with the service node characteristics that you 
want to remain in effect when the system is shut down and restarted. Your 
service node characteristics in the LTLOAD.COM file are initiated upon 
system startup. 

The service node characteristics specified interactively with the LATCP SET 
command remain in effect until your service node is shut down. 

Note: Before you use the LATCP commands interactively, you must load and 

start the LAT port driver either manually or by executing LTLOAD.COM. 
If DECnet is going to be started on your node, you must start DECnet 
before starting the LAT port driver. 



5.8.1 Invoking LATCP 



Before invoking LATCP, you need CMKRNL privileges. To invoke LATCP, 
define a symbol for LCP, as follows; 

$ LCP :== $LATCP 

After defining the foreign command LCP, you can enter LATCP commands 
at the DCL prompt by starting each command with the expression LCP. For 
example: 

$ LCP SET NODE DUKE 

To use the default SYS$NODE logical name, enter a LATCP command at the 
DCL prompt, as follows: 

$ LCP SET NODE 
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Alternatively, you can define a sjnubol, such as LCP, then enter that symbol 
to invoke LATCP, as follows: 

$ LCP 

In this case, the system issues the LCP> prompt, and you can enter multiple 
LATCP commands v^ithout typing LCP before each command. For example: 

LCP> SET NODE DUKE 
LCP> START NODE 



5.8.2 Using HELP for LATCP Commands 



With the LATCP HELP command, you can get general information on all of 
the LATCP commands. In addition, you can get syntax information for each 
LATCP command. To get syntax information for a LATCP command, specify 
HELP and the command name, as follows: 

LCP> HELP SET NODE 

This command displays the format and qualifiers for the SET NODE 
command. 



5.8.3 Exiting from LATCP 



To exit from the LATCP utility and return to the DCL command level, enter 
the following command: 

LCP> EXIT 

Pressing |ctrl/z| has the same effect as the EXIT command. 



5.8.4 Loading and Starting the LAT Port Driver 



The following procedure is recommended for loading the LAT port driver 
interactively. Load the driver by using the following SYSGEN command (you 
must have CMKRNL privileges): 

SYSGEN> CONNECT LTAO: /NOADAPTER 

To return to DCL, use the follov^ng command: 

SYSGEN> EXIT 

To start the LAT port driver, use the following command: 

LCP> START NODE 

This command starts the LAT port driver on your service node. 

Note: Set up your node and service characteristics before starting the LAT port 
driver. 
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5.8.5 Stopping the LAT Port Driver 



Before stopping the LAT port driver, it is suggested that you use the DCL 
REPLY command to notify system users. See the STOP NODE command in 
Chapter 8 for an example. To stop the LAT port driver, use the following 
command: 

LCP> STOP NODE 

This command shuts down the LAT port driver and disconnects all sessions 
to your node. 



5.8.6 Displaying Your Service Node Characteristics 



To display the characteristics for your service node, use the following 
command: 

LCP> SHOW CHARACTERISTICS 

This command displays characteristics and service information for your 
service node. See the SHOW CHARACTERISTICS command in Chapter 8 for 
an example of the display. 



5.8.7 Changing a Service Name 



To change a service name, first eliminate the service using the DELETE 
SERVICE command. Then enter a CREATE SERVICE command to assign a 
new service name. The following is an example: 

LCP> DELETE SERVICE SALES 
LCP> CREATE SERVICE ACCOUNTING 

If you do not specify a service name with the DELETE SERVICE command, 
the service name, which is the translation of the SYS$NODE logical name, is 
deleted. 



5.8.8 Changing a Service Announcement 



You can change the service announcement string by using the SET SERVICE 
command. For example, the following command changes the announcement 
string for the service SALES to "A Member of the Sales Cluster": 

LCP> SET SERVICE SALES /IDENT="A Member of the Sales Cluster" 



5.8.9 Changing a Service Rating 



You can change a static service rating to a dynamic service rating by using the 
following command: 

LCP> SET SERVICE SALES /NOSTATIC.RATING 

The service ratings placed in subsequent multicast messages are calculated 
dynamically on the basis of your service node's activity. 
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This chapter discusses the LATCP commands required to associate remote 
printers with your service node, and the DCL commands necessary to set up 
a remote printer as a spooled device and to set up print queues. This chapter 
also discusses troubleshooting for remote printer queues. 

At system startup, the LATCP commands necessary to set up the remote 
printers on your service node will be effective if you entered them previously 
in the LTLOAD.COM procedure. You then need to create a command 
procedure for the DCL commands. 

An example of the LTLOAD.COM file is shown in Chapter 5. An example 
of a command procedure for setting up and starting print queues on an 
individual node is shown in Example 6-1; an example for nodes on a 
VAXcluster is shown in Example 6-2. 

To set up a remote printer for your service node, you need to do the 
following: 

1 Create applications ports on the service node (Section 6.1). 

2 Map applications ports to server ports (Section 6.2). 

3 Set up Printer Characteristics (Section 6.3). 

4 Define the form for the remote printer (Section 6.3.2). 

5 Set up the remote printer as a spooled device (Section 6.3.3). 

6 Initialize and start the queue(s) (Section 6.3.4). 

7 When appropriate, set up remote printing on VAXclusters (Section 6.4). 

Note: This chapter does not discuss all of the qualifiers used in the examples. 
Refer to the VAX/VMS DCL Dictionary for information on these 
qualifiers. 



6. 1 Creating Applications Ports on Service Nodes 



The logical device for an application program on your service node is called 
an applications port. The LATSYM print symbiont on your service node uses 
an applications port to access a remote printer. Use LATCP commands to 
create an applications port by specifying a port name in the form LTAn:, 
where n is a number from 1 through 9999. The following is an example of 
creating an applications port: 

CREATE PORT LTA321: /APPLICATION 

This command creates the applications port LTA321: 
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6.2 Mapping Applications Ports to Server Ports and Services 

You need to logically associate (map) an applications port with a remote 
printer on a server. To do this, use the SET PORT command to specify 
the applications port name and the server name, plus one or both of the 
following: 

• Server port name 

• Remote service name 

The service name on the server is associated with one or more specific ports 
on that server. 

Note: Obtain the server port name, server name, and remote service name from 
the server manager. 

The following example shows the applications port LTA321: (created in the 
previous example) being mapped to a remote printer by using the SET PORT 
command. The name of the appUcations port (LTA321:), the server (LATl), 
and the server port (LN03) are specified: 

SET PORT LTA321: /APPLICATION /N0DE=UT1 /P0RT=LN03 

The /APPLICATION qualifier specifies that the LTA321: port on the service 
node functions as an applications port. 

The next example shows the applications port LTA322: being mapped to a 
set of remote printers on a server using the SET PORT command. The names 
of the applications port, the server, and the remote service are specified. 

SET PORT LTA322: /APPLICATION /N0DE=LAT1 /SERVICE=PRINTER 

The service PRINTER represents an available remote printer. 

Use a service name when the server has more than one printer and you don't 
care which printer the server selects. This gives you a better chance of getting 
a printer when you need it. 

Note: You need the server manager to assign a service name to a bank of 
printers on the server. Not all servers support remote services. 

6.3 Setting Up Printer Characteristics for non-Clustered Nodes 

You can create a command procedure that configures your remote 
printers, using DCL commands. Once you configure your remote 
printers in the command procedure, call the command procedure in your 
SYS$MANAGER:SYSTARTUP.COM. This ensures automatic configuration for 
your remote printers on system startup. 

Using the command procedure allows you to maintain remote print 
queues separately from other queues on a node. This separation is useful 
because queues for local applications devices usually are started before 
the LTLOAD.COM file is executed, while remote print queues must be 
started afterward. Separation also reduces the possibility of unintentionally 
interfering with the other applications devices and queues on your node when 
you are setting up applications ports and queues for remote printers. 

Example 6-1 is a sample of a command procedure for setting up remote 
printer characteristics and for starting the queues for those printers. 
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Example 6-1 Command Procedure for Configuring Remote Printers 



This command procedure sets up the local characteristics and 
print queues for remote printers. The remote printers should have 
been mapped to the applications ports by the LTL0AD.COM command 
procedure. NOTE: The queue manager must be running before executing 
this file. 

Set up local characteristics for the remote printers. 

SET TERMINAL LTA321 : /PERM /DEVICE=LN03 /WIDTH=255 /PAGE=60 - 

/LOWERCASE /NOBROAD 
SET TERMINAL LTA322: /PERM /DEVICE=LA210 /WIDTH=255 /PAGE=66 - 

/NOBROAD 

! Set the remote printers spooled. 



$ 

$ 

$ ! 

$ ! 

$ 

$ 

$ 

$ ! 

$ ! 

$ 

$ 



SET DEVICE LTA321: /SPOOLED= (LN03$PRINT . SYS$SYSDEVICE : ) 
SET DEVICE LTA322: /SP00LED=(LA21O$PRINT,SYS$SYSDEVICE:) 

Define a form to use with the remote printers. Be sure to use a 
form number that has not already been used. 

DEFINE/FORM LN.FORM 10 /WIDTH=80 /STQCK=DEFAULT /TRUNCATE 

Initialize the remote printer queues. 

The following assumes that the queue manager has been started. 

INITIALIZE/QUEUE /START /PROCESSOR=LATSYM /FaRM_MOUNTED=LN_FaRM - 
/RETAIN=ERROR /DEFAULT= (NOBURST . FLAG=ONE , NOTRAILER) - 
/RECORD_BLOCKING LN03$PRINT /0N=LTA321: 

INITIALIZE/QUEUE /START /PR0CESSOR=LATSYM /RETAIN=ERROR - 

/DEFAULT= (NOBURST , FLAG=ONE . NOTRAILER) /RECORD.BLOCKING 
LA210$PRINT /0N=LTA322: 



6.3.1 Setting Up Terminal Characteristics for Remote Printers 

Once you map an applications port on your service node to a remote printer, 
(see Section 6.2), use the DCL SET TERMINAL command to specify terminal 
characteristics for the remote printer. 

Refer to Appendix B for a list of supported printers and the associated 
terminal characteristics that you must specify for each printer. When you 
specify a device type, the characteristics for that device are automatically 
assigned. In the following example, the SET TERMINAL command sets up 
the automatic line width and page length for the LA210 printer. 

$ SET TERMINAL LTA322: /PERMANENT /DEVICE=LA210 /NOBROADCAST 

Alternatively, you can override the automatic line width and page length 
values for a device by entering different width and page values. For example, 
a laser printer can load special font files if you override the printer's automatic 
page width using the following command: 

$ SET TERMINAL LTA322: /PERMANENT /DEVICE=LN03 /WIDTH=255 - 
/PAGE=66 /NOBROADCAST 

This command sets the page width for the LN03 printer to 255. 
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Do not use the SET TERMINAL/WIDTH command to specify paper width, 
instead use the DEFINE/FORM command described in Section 6.3.2. 

Note: The /PERMANENT and /NOBROADCAST qualifiers must be specified 
for remote printers. 



6.3.2 Defining a Form for a Remote Printer 



The DEFINE/FORM command defines a form name and number, as well 
as the physical paper stock. Do not issue DEFINE/FORM unless the queue 
manager is running. Define a new form if no appropriate form exists on your 
system. To look at the form names and form numbers currently defined on 
your service node, use the SHOW QUEUE/FORM command. 

All DEFINE/FORM commands should resemble the following example, 
which defines a form named LN_FORM and numbered 10: 

$ DEFINE/FORM LN.FORM 10 /WIDTH=80 /STOCK=DEFAULT /TRUNCATE 

When a print job is submitted without a /FORM qualifier, the symbiont uses 
the default stock for the job. This is important, because the stock of a job 
must match the stock of the queue, or the job remains pending on the queue 
and does not print. The /STOCK=DEFAULT qualifier gives the system-wide 
default for paper stock to the form. Then, by assigning this form to a queue 
using INITIALIZE/QUEUE (see Section 6.3.4), you allow jobs without a 
/FORM qualifier to print, because both job and queue require the default 
stock. Note that if a user specifies a form other than the queue's form, the job 
still can print if the two forms use an identical stock. In this case, however, 
the flag page can be incorrectly formatted. 

By specifying the default stock for the form that the queue uses, you reduce 
the likelihood of such problems. Other methods for avoiding problems with 
incompatible stock designations are discussed in the section on printing jobs 
(Section 6.5) and on troubleshooting (Section 6.6). 

Note: The /STOCK=DEFAULT parameter works only when a system-wide 

default exists. If printers were not used on your system before, a default 
stock may not exist for the system. If your system lacks this default, add 
the following command to the procedure for setting up remote printers or 
at the top of the file you use for defining print forms: 

$ DEFINE/FORM DEFAULT /WIDTH=132 /STOCK=DEFAULT 



6.3.3 Setting Up a Remote Printer as a Spooled Device 



Use the SET DEVICE/SPOOLED command to set up a remote printer as a 
spooled device. For example, the following command sets the applications 
port LTA322: as a spooled device associated with the queue LA210$PRINT: 

$ SET DEVICE LTA322: /SP0DLED=(LA21O$PRINT.SYS$SySDEVICE: ) 
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6.3.4 Initializing Queues for Remote Printers 

The INITIALIZE/QUEUE command in the following example initializes the 
queue for a remote printer. 

$ INITIALIZE/QUEUE /START /PROCESSQR=LATSYM /FORM_MOUNTED=DEFAULT - 
/RETAIN=ERROR /DEFAULT= (NOBURST . FLAG=ONE . KOTRAILER) - 
/RECORD.BLOCKING LA210$PRINT /0N=LTA322: 

Do not issue the INITIALIZE/QUEUE command unless the queue manager 
is running. For information on the queue manager, refer to the VAX/VMS 
System Manager's Reference Manual. 

Among other things, the qualifiers used with the INITIALIZE/QUEUE 
command start and set up remote printers, as follows: 

• /START starts the queue. 

• /PROCESSOR=LATSYM specifies the LAT print symbiont, which is 
required for remote printers. 

• /FORM_MOUNTED=DEFAULT assigns a defauh form to the queue. 
Defining a default form is discussed in Section 6.3.2. 

Note that it is not necessary to include the /FORM -MOUNTED qualifier 
if the queue uses the system- wide default form. 

• LA210$PRINT names the queue. 

• /ON=LTA322: specifies an applications port associated with the remote 
printer. The applications port must have been previously mapped to the 
printer with the SET PORT command (see Section 6.2). 

• /RETAIN=ERROR ensures that error status messages are generated. 

An error status at a remote device cannot be passed back directly to 
the queue manager. Thus, when a connection with a server cannot 
be made, no error status is sent to the user. However, specifying the 
/RETAIN=ERROR qualifier in the INITIALIZE/QUEUE command ensures 
that you can get status for such an error. When this qualifier is in effect, 
a job that fails because of a problem on the network is labeled with 
an error status message, such as "Checkpointed:". See Section 6.6 on 
troubleshooting for additional information about checkpointed errors. 



6.4 Setting Up Remote Printing on VAXclusters 



On a VAXcluster, it is recommended that you configure applications ports 
on at least two nodes, so that a redundant path to the device is available 
in the event of a failure of a cluster node. To configure a remote-printer 
applications port on a cluster node, include LATCP CREATE PORT and SET 
PORT commands for that port in the node's LTLOAD.COM file. 
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6.4.1 Guidelines for Command Procedures on VAXclusters 



On VAXclusters, where management of remote printers can become complex, 
the following order of events must be adhered to, although additional events 
can occur between the listed events: 

• DECnet is started. 

• LAT is started, applications ports for remote printers are established when 
you invoke the LTLOAD.COM file. 

You can have node-specific LTLOAD.COM files for nodes on the 
cluster with different LAT characteristics. You can alternatively have 
a cluster common LTL0AD.COM file for nodes that have identical LAT 
characteristics. Note that not all nodes require applications ports defined 
for remote devices. 

• Queues to remote printers are set up and started (queue manager must be 
running). 



6.4.2 Queues In a VAXcluster Environment 



Queues are used in several ways in a VAXcluster environment. On one node, 
you can set up a device-specific queue that points to one remote printer on 
a server. A device-specific queue always points to a particular device. The 
remote printer must be mapped to an applications port on the node. To 
initialize the device-specific queue on one node, define the device-specific 
queue in the startup command procedure for that node. 

You can also set up a generic queue on one node to handle requests for 
several remote printers. On this same node, you need to first create a device- 
specific queue for each printer. The generic queue points to the printers via 
each printer's device-specific queue. In this case, there is one path to each 
remote printer. Each printer is mapped to an applications port on this node. 
To initialize a generic queue on one node in the cluster, define the device- 
specific queues and the generic queue in the startup command procedure for 
that node. 

Finally, you can set up a generic queue that provides a redundant path via 
several nodes to several remote printers. The generic queue points to the 
remote printers via each printer's device-specific queue. Each printer must 
have a device-specific queue on each participating node. Notice that each 
printer must be mapped to the same applications port on each participating 
node. Define the generic queue and the device-specific queue in the startup 
command procedure for each node using the generic queue. 

Example 6-2 consists of a generic queue for one printer and a generic queue 
for two printers. See Section 6.3 for an explanation of the other commands 
used in this example. 

Refer to the VAX/VMS Guide to VAXclusters and the VAX/VMS System 
Manager's Reference Manual for detailed information about generic output 
queues. 
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Example 6-2 Command Procedure for Configuring Remote Printers Using a Generic Queue 



This is an example of a cluster coimand procedure which sets up 
characteristics and queues for remote printers. 

This file assumes that two nodes in the cluster access the remote 
devices, and that only those nodes call this file. 

Compute the name of the executing node. 



$ 
$ 

$ NODE = F$GETSYI("NODENAME") 

$ ! 

$ DUKE.START = "/NOSTART" 

$ EARL.START = "/NOSTART" 

$ ! 

$ ! Redefine one of the previous symbols 

$ ! 

$ 'NODE' .START = "/START" 

$ 

Set up local characteristics for the remote printers 



This procedure assumes that the remote printers have been mapped 
to the same applications port on each node that accesses them. 



$ 
$ 
$ 
$ 

$ 

$ SET TERMINAL LTA401: /PERM /DEVICE=LA38 /WIDTH=80 /PAGE=60 - 

/LOWERCASE /NOBROADCAST 
$ SET TERMINAL LTA402: /PERM /DEVICE=LA120 /NOBROADCAST 

$ ! 

$ ! Set the remote printers spooled. 

$ SET DEVICE LTA401: /SP00LED=('N0DE'$38PRINT,SYS$SYSDEVICE) 
$ SET DEVICE LTA402: /SP00LED=('N0DE'$120PRINT.SYS$SYSDEVICE) 

$ ! 

$ ! Define a form to use with the remote printers. Be sure to use a 

$ ! fonn number that has not already been used. 

$ ! 

$ DEFINE/FORM LA.FORM 10 /WIDTH=80 /STOCK=DEFAULT /TRUNCATE 

$ ! 

$ ! Initialize the remote printer queues. 

$ ! The following assumes that the queue manager has been started. 

$ ! 

$ INITIALIZE/QUEUE /PROCESSOR=LATSYM /FORM_MOUNTED=LA_FORM /RETAIN=ERROR 

/DEFAULT=(NOBURST,FLAG=ONE.NOTRAILER) /RECORD.BLOCKING - 

/ON=DUKE::LTA401: 'DUKE.START' DUKE$38PRINT 



(Continued on next page) 
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Example 6-2 (Cont.) Command Procedure for Configuring Remote Printers Using a 

Generic Queue 



$ ! 

$ INITIALIZE/qUEUE /PROCESSOR=LATSYM /RETAIN=ERROR - 

/DEFAULT=(NOBURST.FLAG=ONE,NOTRAILER) /RECORD.BLOCKING - 

/0N=DUKE::LTA402: 'DUKE_START' DUKE$120PRINT 
$ ! 
$ INITIALIZE/QUEUE /PROCESSOR=LATSYM /F0RM_MOUNTED=LA_FORM /RETAIN=ERROR 

/DEFAULT=(NOBURST.FLAG=ONE,NOTRAILER) /RECORD.BLOCKING - 

/ON=EARL: :LTA401: 'EARL.START' EARL$38PRINT 
$ ! 
$ INITIALIZE/qUEUE /PROCESSOR=LATSYM /RETAIN=ERROR - 

/DEFAULT=(NOBURST,FLAG=ONE.NOTRAILER) /RECORD.BLOCKING - 

/0N=EARL::LTA4O2: 'EARL.START' EARL$120PRINT 
$ 

Initialize the cluster wide generic queues. 



A generic queue with one printer. 



$ 
$ 

$ 
$ 
$ INITIALIZE/QUEUE /START /GENERIC=(DUKE$38PRINT, EARL$38PRINT) - 

SYS$38PRINT 
$ ! 

$ ! A generic queue with two printers. 
$ ! 
$ INITIALIZE/QUEUE /START /GENERIC=(DUKE$38PRINT. DUKE$120PRINT, - 

EARL$38PRINT. EARL$120PRINT) TERMINAL$120PRINT 



6.5 Printing Jobs 



After you set up remote printers, a user on your service node can issue a DCL 
command to print a file. The command in the following example prints the 
file LATDOC.MEM on the remote LA120 printer: 

$ PRINT LATDOC.MEM /QUEUE=SYS$120PRINT 

To avoid problems with flag pages or with queues whose form does not use 
the default stock, assign a system- wide global symbol for each queue. This 
symbol must be assigned in the system-wide login command procedure, 
which defaults to SYS$MANAGER:SYLOGIN.COM. Select a symbol, such as 
3 SPRINT, to represent a PRINT command specifying a given queue and its 
form type. For example; 

$ 38PRINT :== PRINT /QUEUE=SYS$38PRINT /FORM=LA.F0RM 

Instruct users to specify this symbol when they send printing jobs to remote 
queues. The symbol provides the user with an easy and accurate way to print 
the files, as in the following example: 

$ 38PRINT LATDOC.MEM 
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6.6 Troubleshooting Problems with a Remote Printer Queue 

Errors can occur on a print queue for a number of reasons. Several causes of 
errors and suggested responses to some of these are discussed in this section. 

The effect of errors upon the queue varies according to the type of error. An 
error can cause an individual job to remain in a pending state. However, 
some errors cause the entire queue to pause or stop. When the queue stops, 
all jobs on the queue remain in the pending state until the queue is restarted. 
Before you restart a queue, determine and correct the condition that caused it 
to stop. 

Three general types of errors are discussed in this section: 

• Checkpointed errors — Errors that stop the queue and checkpoint the 
current job (holding it for resubmission when the queue restarts). 

These errors are caused by some problem between the service node 
and the server, such as a network problem or an incorrect service name 
assigned to the remote device. 

• Suspended printing errors — Errors that stall the queue suspend printing 
jobs temporarily (permitting partially printed jobs to be left on the queue 
and completed later). 

These errors are caused by a problem in the server and/ or the printer 
while a job is printing, such as the printer running out of paper. 

• Pending errors — Errors that force an individual job to remain in a 
pending state but leave the queue functioning. 

These errors are caused by a print command that specifies a printer form 
whose paper stock is incompatible with the stock specified for the queue. 

Note: Jobs that remain pending for a long time have not necessarily 

experienced an error. Use the SHOW QUEUE/FULL command to 
determine whether a delay in printing was requested by the user. 

These three types of errors and suggested methods of responding to them are 
discussed in greater detail in the remainder of this section. 



6.6.1 Checkpointed Errors 

Checkpointed errors are caused by the failure to create a connection. 

Two types of errors can prevent a connection, and one type can terminate an 
existing connection: 

• Incorrect names assigned for the LTAn: port 

The node name does not match the name of the server, the applications 
port name does not match the name of a server port that allows remote 
access, or the service name does not match the name of a service offered 
by the server. Furthermore, if both a service name and a port name 
are specified, the service must be offered on the port. Check with the 
server manager or network manager to verify that the correct names are 
specified on the service node. 
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• Host-initiated request never received 

For example, in some cases, the server is on a different Ethernet or on an 
Ethernet segment that is currently disconnected. In other cases, the server 
is inactive when the request is sent. 

• Connection abnormally terminated because of a network or server 
problem 

For example, a job is printing when a network problem causes the circuit 
to go down. 

To ensure that checkpointed jobs are identified by an error status message, 
use the /RETAIN=ERROR qualifier in the INITIALIZE/QUEUE command (see 
Section 6.3.4). A checkpointed error status message makes it easy to identify 
a failed job. Refer to Chapter 7 for additional information about error status 
messages. With the job number you can delete a job, if you wish to submit it 
to another queue rather than wait until the problem with the stopped queue 
is resolved. However, if you prefer, you can leave the job on the queue. 

After a checkpointed error occurs, the queue stops or pauses. Identify 
and remove the cause of the error before restarting the queue. Once the 
underlying problem is resolved, reset and restart the queue, as follows: 

$ STOP/QUEUE/RESET queiie-name 
$ START/QUEUE queue-name 

You can resubmit the checkpointed job with the following DCL command: 

$ SET QUEUE gueue-na»ne/ENTRY=entry-ntflBber/NOHOLD 

Refer to the VAX/VMS DCL Dictionary for more details on the 
START/QUEUE command. 



6.6.2 Suspended Printing Errors 



Suspended printing errors occur if the job fails to print completely after it was 
accepted by a server. These errors can result from a problem on the network, 
server, or printer. These printing errors cause the queue to stall, but the job is 
only temporarily suspended. Once the problem is corrected, the job resumes 
printing. 



6.6.3 Pending Errors 



A pending error can occur if the stock associated with a job differs from the 
stock associated with a queue. Any print job whose stock is incompatible 
with the stock of the queue remains in a pending state. However, no error 
message is generated; the job continues to be labeled simply as "Pending" 
until it is deleted or until the stock assigned to the queue is changed. A 
pending error affects only the individual job. The queue does not stop, so 
error-free jobs can continue to print. To resolve a pending error, the stock of 
the queue must be changed to match the job or the job must be deleted and 
submitted to a queue with compatible stock. 

Methods for reducing the occurrence of pending errors include: 

• Assigning the default stock when defining the form to be assigned to a 
queue (see Section 6.3.2). 

When a queue uses the default stock, users need not specify a form in 
print commands, thereby reducing a likely source of error. 
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• Creating a system-wide global symbol for printirig to a queue with a 
nondefault stock (see Section 6.5). 

When users enter this symbol, they avoid pending errors. 

Note that the success of a singular preventative method depends on users 
avoiding print commands that specify forms requiring unavailable stock. 
Therefore, occasionally a user who specifies a form can experience a problem 
with a print job. In this case, the following are possible solutions: 

• You or the user can delete a job requiring an incompatible stock and 
either resubmit the job to the same queue (while specifying a form using 
the suitable stock) or submit the job to a different queue whose stock is 
what the user specified in the original PRINT/FORM command. 

• If an alternative queue is not available and printing a job with a different 
stock is essential, change the stock of the printer and/or the queue. 
Changing the stock involves the following steps: 

• Stopping the queue 

• Changing the physical stock in the printer, if desired 

• Changing the stock specification of the queue to match the new stock 

• Restarting the queue 
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7.1 VAX/VMS Application Programs and LAT Devices 

The LAT software allows application programs to use remote devices on 
a server. A remote device, such as a printer, can be shared over the LAT 
network. A typical LAT network is shown in Chapter 4. Before a remote 
device can be accessed by an application program, the remote device needs 
to be mapped to an applications port on your VMS system. See Chapter 6 
for a discussion about mapping. Once the remote device is mapped, the 
application program can establish and terminate a connection to that device. 
The connection is made through the applications port on your node that is 
associated with the remote device. 

This chapter discusses the QIO interface to the LAT port driver and the 
function code modifiers that you use to establish and terminate connections to 
remote devices. You must use these QIO functions to establish a connection 
to a remote device from an application program. DIGITAL does not support 
any other methods of connection. 

7.2 Using VAX/VMS Function Codes and Modifiers for LAT Devices 

The VAX/VMS I/O terminal function codes are described in the VAX/VMS 
I/O Reference Manual. You cannot use all of those function codes for LAT 
devices. The VAX/VMS terminal port function code modifiers that you can 
use for LAT devices are: 

• All read function code modifiers. 

• All write function code modifiers. 

VAX/VMS does not support the following SET MODE or SET 
CHARACTERISTICS function code modifiers for LAT devices: 

TT$M_MODEM 

TT2$M_SETSPEED 

TT$M_ALTRPAR 

TT$M_BREAK 

TT$M_ALTFRAME 

IO$M_LOOP 

IO$M_UNLOOP 

Read and write modem function code modifiers are not supported for LAT 
devices. 
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Flow control to the physical device is handled by the terminal server instead 
of the host. A separate flow control mechanism exists between the server and 
host. The following terminal characteristics do not apply to LAT terminals: 

• TT$M_HOSTSYNC 

• TT$M_READSYNCH 

• TT$M_TTSYNC 



7.3 LAT Port Driver Function Code 



The LAT port driver accommodates I/O requests from application programs 
for connections to remote devices (for example, a graphics printer) on a 
server. A request for the LAT port driver must include the VMS IO$_TTY_ 
PORT function code. IO$_TTY_PORT allows the VMS terminal device driver 
to forward a LAT-specific request to the LAT port driver. In addition, the 
request must include a LAT port function code modifier. 



7.3.1 LAT Port Function Code IVIodifiers 

The LAT port function code modifiers are: 

• IO$M_LT_CONNECT 

• IO$M_LT_DISCON 



10$M_LT_C0NNECT is the function code modifier that requests the LAT 
port driver to make a connection to a remote device on a server. 10$M_LT_ 
DISCON is the function code modifier that requests the LAT port driver to 
terminate the LAT connection to the remote device. 

When an application program issues an IO$M_LT_CONNECT request for a 
connection to a remote device, one of the following situations occurs: 

• The connection is established. This situation occurs if the connection is 
successful. You can use the device. 

• The connection is timed out. This situation occurs if the server is not 
available, or if an incorrect server name is specified. 

• The connection is rejected. This situation occurs if an incorrect port name 
or service is specified or if the server, service, or remote port is disabled. 

• The request is queued at the server. This situation occurs if the remote 
port is busy when requested. In this case, the QIO is not completed until 
the connection is established, rejected, or timed out. 

When a connection request is queued at the server, the QIO function 
does not complete until the request is removed from the queue. The 
$CANCEL system service does not cancel the queued connection. To 
cancel the connection request, issue an IO$_TTY_PORT!10$M_LT_ 
DISCON disconnect QIO. Include an exit handler in your application 
programs that issues the disconnect QIO on exit. Issuing the disconnect 
QIO to an already disconnected device does not cause any problems. 
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The LAT port driver cannot attempt to connect to a remote device under the 
following circumstances: 

• The request is not to an applications port. In this case, the QIO request 
was probably issued to an interactive port. The LAT port driver rejects 
the request. 

• The requested applications port is busy. In this case, the QIO requests an 
applications port that is already in use. The LAT port driver rejects the 
request. 

After you issue an IO$_TTY_PORT!IO$M_LT_DISCON (disconnect QIO), 
the applications port's UCB momentarily goes off line. If you issue a connect 
QIO for a remote device immediately after a disconnect QIO, it is also 
possible that the connect QIO may rehim a SS$_DEVACTIVE status. In this 
situation, retry the connect QIO. 



7.3.2 Hangup Notification 



To ensure that the terminal driver notifies application programs that are 
writing data of an abnormal connection termination, enable a CTRL/Y AST 
on the channel. To do this, use the IO$_SETMODE function code and 
IO$M_CTRLYAST function code modifier. Note that VMS does not return 
an AST parameter to the CTRL/Y AST routine. 

When an application program wdth a pending read request has an abnormal 
LAT connection termination, the VMS terminal driver returns a SS$_ 
HANGUP hangup notification in the first word of the I/O status block. 



7.3.3 I/O Status Block 



When an application program makes an I/O request for a connection to a 
remote device on a server, the LAT port driver puts status information about 
the request (see Table 7-1) into the first word of the I/O status block. 

If the server rejects the request, the LAT port driver returns a numeric LAT 
rejection reason code in the second word of the I/O status block. This 
numeric code represents the reason for the rejection. Table 7-2 describes the 
LAT rejection reason codes. 
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Table 7-1 IO$M_LT_CONNECT Status 



Event 



Status 



Explanation 



Connection 
established 

Connection 
timeout 



lOSB = SS$_NORIVIAL 



lOSB = SS$_TIMEOUT 



Connection 


lOSB = SS$_ABORT 


rejected 


IOSB+2 = LAT reject 




reason code 


Request is not to 


SS$_ILLIOFUNC 


an applications 


No status in lOSB. QIO is 


port 


rejected immediately. 


Connection 


SS$_DEVACTIVE 


already 


No status in lOSB. QIO is 


established on 


rejected immediately. 


port 





The connection is successful, 
and the device is ready to 
use. 

The connection timed out. 
The server is not available or 
an incorrect server name was 
specified. The timeout period 
is 5 seconds. 

The connection cannot be 
made. The LAT port driver 
updates the I/O status block. 

The QIO request is not to 
an applications port. The 
LAT port driver rejects the 
request. 

The QIO request is for an 
applications port already in 
use. The LAT port driver 
rejects the request. 



Note: If a request for a connection is queued on the server, the QIO is not 
completed until the connection is established, rejected, or timed out. 

The LAT port driver puts status information about a connection request into 
the first word of the I/O status block. An example of how a status block 
might look after an I/O request is shown in Figure 7-1. 

Figure 7-1 First Word of the I/O Status Block 



lOSB 



REJECTION REASON 
CODE 


STATUS 


(RESERVED) 


(RESERVED) 



ZK-6006-HC 



The rejection reason code for abort status at the IOSB+2 refers to the rejection 
codes shown in Table 7-2. This field is only valid when a QIO request has 
the abort status. 
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Table 7—2 LAT Rejection Reason Codes for Abort Status 

Value Reason 

Unknown 

2 System shutdown in progress 

5 Insufficient resources at server 

6 Port or service in use 

7 No such service 

8 Service is disabled 

9 Service is not offered on the requested port 

10 Port name is unknown 

13 Immediate access rejected 

14 Access denied 

15 Corrupted request 

16 Requested function is not supported 

1 7 Session cannot be started 

1 8 Queue entry deleted by server 

1 9 Illegal request parameters 



7.4 Programming Example 



lit this example, the program requests a connection to an applications port. 
The program uses the LAT/VMS port function code and the function code 
modifiers for the LAT port driver to solicit the connection to the applications 
port. 
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Example 7-1 Application Program for Connecting to a Remote Device 



.TITLE LAT APPLICATIONS PORT PROGRAMMING EXAMPLE 
.IDENT /l.O/ 

^:tt*^i!^*i^!^*^llfi^*}lf#*ilitiif:it*ifififMfif*if^:llf*it:llf*'lf**if ************************* 

LAT APPLICATIONS PORT PROGRAM 

*******************************************^***t^^:ifi4:^^:Tlp^dp^i^il;;H;^ii: 

.SBTTL DECLARATIONS 
DEFINE SYMBOLS 



$IODEF 
$qiODEF 

DECLARE EXIT HANDLER CONTROL BLOCK 

EXIT_HANDLER_BLOCK : 

.LONG 

.LONG EXIT.HANDLER 

.LONG 1 

.LONG STATUS 
STATUS: .BLKL 1 



I/O FUNCTION CODES 
QIO DEFINITION CODES 



SYSTEM USES THIS FOR POINTER 
ADDRESS OF EXIT HANDLER 
ARGUMENT COUNT FOR HANDLER 
DESTINATION OF STATUS CODE 
STATUS CODE FROM $EXIT 



ALLOCATE TERMINAL DESCRIPTOR AND CHANNEL NUMBER STORAGE 
TT.DESC: 



.ASCID /SYS$INPUT/ 



TT.CHAN : 



LT.DESC : 



LT.CHAN : 



-BLKW 



1 



.ASCID /LTA700:/ 



.BLKW 



; APPEND <CR><LF> TO MESSAGE 

OUT.MSGLEN = 2 

OUT.MSG: 

.ASCII <CR><LF> 



; NAME OF TERMINAL 

; TT CHANNEL NUMBER STORAGE 

; NAME OF LT DEVICE 

; LT CHANNEL NUMBER STORAGE 



(Continued on next page) 
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Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



ALLOCATE INPUT BUFFER 



IN.BUFLEN = 80 
IN_BUF : 

.BLKB 
IN.IOSB: 

.BLKQ 
SOL.IOSB : 

.BLKQ 



IN.BUFLEN 
1 
1 
DEFINE CARRIAGE CONTROL SYMBOLS 



CR=*XOD 
LF=-XOA 

DEFINE OUTPUT MESSAGES 



MESSAGES ARE ACCESSED BY INDEXING INTO A TABLE OF LONGWORDS 
WITH EACH MESSAGE DESCRIBED BY A MESSAGE ADDRESS AND LENGTH 



ALLOCATE CHARACTER BUFFER 

INPUT I/O STATUS BLOCK 

SOLICT CONNECT QIO I/O STATUS BLOCK 



CARRIAGE RETURN 
LINE FEED 



MSG_TABLE : 




.LONG 


01$ 


.LONG 


05$ 


.LONG 


10$ 


.LONG 


15$ 


.LONG 


20$ 


.LONG 


25$ 


.BLKQ 


2 


.LONG 


50$ 


.LONG 


55$ 


.LONG 


60$ 


.LONG 


65$ 


.LONG 


70$ 


.LONG 


75$ 


.LONG 


80$ 


.LONG 


85$ 


.LONG 


90$ 


.LONG 


95$ 


.LONG 


100$ 


.LONG 


105$ 


.BLKQ 


2 



TABLE OF MESSAGE ADD. AND LEN. 

FIRST MESSAGE ADDRESS 

FIRST MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

BLANK MESSAGE CODES 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

MESSAGE ADDRESS 

MESSAGE LENGTH 

BLANK MESSAGE CODES 



(Continued on next page) 
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Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
.LONG 
-LONG 
.LONG 
.LONG 

MESSAGES 

01$: .ASCII 
05$=. -01$ 



130$ 
135$ 
140$ 
145$ 
150$ 
155$ 
160$ 
165$ 
170$ 
175$ 
180$ 
185$ 
190$ 
195$ 



/REASON UNKNOWN/ 



MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 
MESSAGE 



ADDRESS 

LENGTH 

ADDRESS 

LENGTH 

ADDRESS 

LENGTH 

ADDRESS 

LENGTH 

ADDRESS 

LENGTH 

ADDRESS 

LENGTH 

ADDRESS 

LENGTH 



10$: 
15$= 



.ASCII <CR><LF>/C0NNECTION ESTABLISHED/ 



-10$ 



20$: .ASCII 
25$=. -20$ 



/SYSTEM SHUTDOWN IN PROGRESS/ 



50$: .ASCII 
55$=. -50$ 



/INSUFFICIENT RESOURCES/ 



60$: .ASCII 
65$= . -60$ 



/PORT OR SERVICE IN USE/ 



70$: .ASCII 
75$=. -70$ 



/NO SUCH SERVICE/ 



80$: .ASCII 
85$= . -80$ 



/SERVICE IS DISABLED/ 



90$: .ASCII 
95$=. -90$ 



/SERVICE NOT OFFERED BY REQUESTED PORT/ 



100$: .ASCII 
105$=. -100$ 



/PORT NAME IS UNKNOWN/ 



(Continued on next page) 
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Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



130$: .ASCII /IMMEDIATE ACCESS REJECTED/ 
135$=. -130$ 

140$: .ASCII /ACCESS DENIED/ 
145$=. -140$ 

150$: .ASCII /CORRUPTED REQUEST/ 
155$=. -150$ 

160$: .ASCII /REQUESTED FUNCTION IS NOT SUPPORTED/ 
165$=. -160 

170$: .ASCII /SESSION CANNOT BE STARTED/ 
175$=. -170$ 

180$: .ASCII /QUEUE ENTRY DELETED BY LOCAL NODE/ 
185$=. -180$ 

190$: .ASCII /ILLEGAL REQUEST PARAMETERS/ 
195$=. -190$ 

NOTCON: .ASCII <CR><LF>/CONNECTI0N REJECTED - / 

N0TCQNL=.-N0TC0N 

STATIC QIO PACKETS FOR MESSAGE OUTPUT USING QIO$_G FORM 

WRITE.QIO : 

$QIO FUNC=IO$_WRITEVBLK ! IO$M_BREAKTHRU! IO$M_REFRESH, - 
EFN=1 

ERROR_QIO : 

$QIO FUNC=IO$_VmiTEVBLK ! IO$M_BREAKTHRU! IO$M_REFRESH. - 
EFN=1 



.SBTTL MAIN ROUTINE 



FUNCTIONAL DESCRIPTION: 



(Continued on next page) 
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Example 7—1 (Cont.) Application Program for Connecting to a Remote Device 



MAIN PROGRAM ROUTINE 

The following code assigns a channel to the 
applications port and attempts to create a connection 
to that port. The connection status is displayed on 
the users terminal. Input from the users terminal 
is output on the applications port: *C input from the 
user terminates the program. 

INPUT PARAMETERS: 
None. 

OUTPUT PARAMETERS: 
None. 



START: 



10$: 



.WORD 



; ENTRY MASK 



Assign channels 






$ASSIGN_S 


DEVNAM=TT_DESC,- 


; ASSIGN CHANNEL TO USERS 




CHAN=TT_CHAN 


; TERMINAL 


BLBS RO. 10$ 




; NO ERROR IF SET 


BRW ERROR 




; ELSE, ERROR 


$ASSIGN_S 


DEVNAM=LT_DESC,- 
CHAN=LT_CHAN 


; ASSIGN CHANNEL TO LT DEVICE 


BLBS RO. 20$ 




; NO ERROR IF SET 


BRW ERROR 




; ELSE, ERROR 



Enable ~C on user terminal aind 'Y on applications port . 
Post read to user terminal and solicit connection to 
applications port . 



20$: 


BSBW 


ENABLE.CTRLCAST 




BSBW 


SOL.CONNECT 




BSBW 


ENABLE.READ 


30$: 


NOP 






BRB 


30$ 




RET 





ENABLE CONTROL C AST'S 

TRY TO CONNECT TO LT DEVICE 

QUEUE READ 

KEEP LOOPING UNTIL "C 



(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



.SBTTL ENABLE_CTRLYAST - Enable CTRLYAST on applications port 
++ 

FUNCTIONAL DESCRIPTION: 

Routine to allow hangup notification. This routine enables 
CTRLY AST delivery for the applications port. This routine will 
be called if an abnormal termination occurs to the remote 
device. 

INPUT PARAMETERS: 

None. 
OUTPUT PARAMETERS: 

None 



ENABLE.CTRLYAST: 

$QIOW_S CHAN=LT_CHAN.- 

FUNC=#IO$_SETMODE ! IO$M_CTRLYAST . - 



P1=HANGUP.- 

P3=#3 
BLBS RO. 10$ 
BRW ERROR 



AST ROUTINE ADDRESS 

USER MODE 

NO ERROR IF SET 



10$ : RSB 

.SBTTL HANGUP - AST Routine for Control Y 
n- 

FUNCTIONAL DESCRIPTION 

AST routine to execute when "Y status is returned for the 
applications port. This status is returned when the 
connection to the remote device is abnormally terminated. 

INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS: 
None 



(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



HANGUP : 



.WORD -MO 
MOVZWL #SS$_HANGUP.RO 
BRW ERROR 



; INDICATE HANGUP 
; AND EXIT 



.SBTTL ENABLE.READ - QUEUE A READ TO THE TERMINAL 



FUNCTIONAL DESCRIPTION 

Routine to queue a read to the terminal . The queued 
read will not affect writes due to the fact that 
breakthru has been set for writes. 



INPUT PARAMETERS; 
None 

OUTPUT PARAMETERS: 
None 



MUST NOT BE QIOW FORM 



ENABLE.I 


lEAD: 






$QIO_S 


CHAN=TT_CHAN, - 

FUNC=#IO$_READVBLK 

IOSB=IN_IOSB,- 

ASTADR=READAST,- 

P1=IN_BUF . - 

P2=#IN_BUFLEN 




BLBS 


R0,10$ 




BRW 


ERROR 


10$: 


RSB 




' 


. SBTTL 


READAST - AST Rout 



NO ERROR IF SET 



AST Routine for Read Completion 



FUNCTIONAL DESCRIPTION 



(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7—1 (Cont.) Application Program for Connecting to a Remote Device 



AST routine to execute on read completion. The data which 
was input to/from the users terminal is output on the 
applications port. Another read is then posted. 

INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS: 

None 



PROCEDURE ENTRY MASK 

CHECK lOSB FOR SUCCESS 

PUT ERROR STATUS IN RO 

EXIT WITH ERROR 

GET NUMBER OF CHARACTERS READ 

ADD SIZE OF FIXED ACK 

OUTPUT MESSAGE TO LT DEVICE 



QUEUE NEXT READ 

.SBTTL ENABLE.CTRLCAST - ENABLE CONTROL C AST 
FUNCTIONAL DESCRIPTION: 

Routine to allow CONTROL C recognition on users terminal 
INPUT PARAMETERS: 

None. 
OUTPUT PARAMETERS: 

None 



READAST: 








.WORD 


-M<R2.R3.R4,R5> ; 




BLBS 


IN_I0SB.10$ ; 




MOVZWL 


IN.IOSB, RO ; 




BRW 


ERROR ; 


10$: 


MOVZWL 


IN_I0SB+2,RO 




ADDL2 


#0UT_MSGLEN.R0 




$qio_s 


CHAN=LT_CHAN,- 
FUNC=#IO$_WRITEVBLK . - 
P1=0UT_MSG,- 
P2=R0 




BSBW 


ENABLE_READ 




RET 





(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



ENABLE_CTRLCAST: 

$QIOW_S CHAN=TT_CHAN.- 

FUNC=#IO$_SETMODE ! IO$M_CTRLCAST . - 



P1=CTRLCAST.- 

P3=#3 
BLBS RO, 10$ 
BRW ERROR 



AST ROOTINE ADDRESS 

USER MODE 

NO ERROR IF SET 



10$ : RSB 

.SBTTL CTRLCAST - AST Routine for Control C 
n- 

FUNCTIONAL DESCRIPTION 

AST routine to execute when 'C is received. The connection 

to the applications port is stopped and the program is terminated 

with normal completion status. 

INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS: 

None 



CTRLCAST : 

.WORD -MO 

$QID_S CHAN=LT_CHAN , - ; DISCONNECT SESSION TO LT DEVICE 
FUNC=#IO$_TTY_PORT ! IO$M_LT_DISCON 
ERROR: $EXIT_S RO : EXIT 

RSB 

.SBTTL SOL_CONNECT - Solicit Connection to Applications Port 



FUNCTIONAL DESCRIPTION: 

This routine issues the QIO to the LT driver to solicit 
the connection to the applications port. 



(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7—1 (Cont.) Application Program for Connecting to a Remote Device 



INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS; 
None 



SOL.CONNECT: 

$QIO_S 



10$: 



BLBS 

BRW 

RSB 



CHAN=LT_CHAN , - 

FUNC=#IO$_TTY_PORT ! ID$M_LT_CONNECT , 

ASTADR=SOLAST.- 

IOSB=SOL_IOSB 

R0.10$ 

ERROR 



.SBTTL SOLAST - AST Routine for connection solicitation status 



FUNCTIONAL DESCRIPTION 

AST routine to execute when connection solicitation is 
complete. If status is success, print success message and 
return. If status is rejection, print reject message plus 
reject reason and exit. If status is otherwise, exit. 

INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS: 
None 



(Continued on next page) 
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LAT Port Driver QIO INTERFACE 



Example 7-1 (Cont.) Application Program for Connecting to a Remote Device 



SOLAST : 



.WORD 


-M<> 


MOVZWL 


SOL.IOSB.RO 


BLBC 


R0.10$ 


MOVL 


RO.Rl 


JSB 


WRITE.STATUS 


BSBW 


ENABLE.CTRLYAST 


RET 




10$ : CMPW 


RO,#SS$_AB0RT 


BNEQ 


ERROR 


$QIOW_G 


ERROR.qiO 


MOVZWL 


S0L_I0SB+2.R1 


MOVZWL 


TT_CHAN,ERR0R_QI0+8 


JSB 


WRITE.STATUS 


BRW 


ERROR 


WRITE.STATUS: 




MOVQ 


MSG_TABLE[R1].- 




WRITE_QI0+QI0$_P1 


MOVZWL 


TT_CHAN.WRITE_giO+8 


$QIOW_G 


WRITE.QIO 


RSB 




. SBTTL 


EXIT.HANDLER: 



GET RETXmN STATUS 

IF CLEAR, ERROR 

COPY STATUS CODE FOR INDEX 

OUTPUT SUCCESS MESSAGE 

ENABLE CONTROL Y AST'S 

IS THIS A REJECTED CONNECTION? 
IF EQ, OUTPUT ERROR MESSAGE 
OUTPUT ERROR MESSAGE FIRST 
SET Rl FOR OFFSET INTO TABLE 
INSERT CHANNEL INTO QIO PACKET 
OUTPUT ERROR REASON 
EXIT 

PUT MESSAGE INTO QIO 

INSERT CHANNEL INTO QIO PACKET 



FUNCTIONAL DESCRIPTION: 

Exit handler routine to execute when image exits, 
cancel any outstanding I/O on these channels . 

INPUT PARAMETERS: 
None 

OUTPUT PARAMETERS: 
None 



It will 



EXIT_HANDLER: 
.WORD 



$CANCEL_S 

$CANCEL_S 

RET 

.END START 



CHAN=TT_CHAN 
CHAN=LT_CHAN 



; FLUSH ANY OUTPUT 



7-16 



8 LATCP Command Descriptions 



This chapter contains an alphabetical reference of all the LAT/VMS LATCP 
commands. Chapters 5 and 6 provide examples of some of the commands 
described in this chapter. 

The LATCP utility allows you to control and obtain information from the LAT 
port driver (LTDRIVER). Using LATCP, you can do the following: 

• Start and stop the LAT port driver 

• Specify configuration characteristics for your service node and its services 

• Modify and display configuration characteristics 

• Show and zero system counters 

Entering Commands 

To enter LATCP commands, invoke LATCP at the DCL prompt, as follows: 

$ RUN SYS$SYSTEM : LATCP 

Once LATCP is invoked, the system issues the LCP> prompt. You can enter 
LATCP commands using the following format: 

command-keyword [parameteris)] [/qualifier(s)] 

You can enter multiple qualifiers and their arguments on one command line; 
qualifiers are separated by slashes (/). Also, you can continue a command to 
a new line by typing a hyphen and then pressing I ret I . For example: 

LCP> SET NODE DUKE /IDENT="SALES VAXCLUSTER" - RET 
_LCP> /MULTICAST_TIMER=50 /ENABLE=(1,2) 

You can enter LATCP commands in either uppercase or lowercase characters 
(or a combination of both). Command lines can be up to 132 characters in 
length. 

Commands can be abbreviated to their shortest unique length. For example, 
the commands SHOW CHARACTERISTICS and SHOW PORTS can be 
abbreviated as SH CH and SH PO respectively. However, to avoid ambiguity 
and possibly entering a command by accident, it is recommended that you 
abbreviate all commands to no fewer than three characters. 

Error messages for the LATCP commands are shown in Appendix C. 

Review the graphics conventions in the Preface. These conventions are used 
in the command descriptions in this chapter. 
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CREATE PORT 



Creates an applications port on your service node. 



FORMAT 

port-name 



CREATE PORT 



Command Qualifiers 

/APPLICATION 
/[NOJLOG 



Defaults 

/APPLICATION 
/LOG 



RESTRICTIONS • LTAO: is not a valid parameter. 

• An error is returned if the specified port already exists. 



PARAMETERS port-name 

Specifies the name of the applications port to be created in the form LTAn:, 
where n is a unique number from 1 through 9999. 



DESCRIPTION 



The CREATE PORT command creates an applications port on your LAT 
service node. The applications port must be logically associated (mapped) 
with a remote device on a server. Use the SET PORT command to do this 
mapping. 



COMMAND 
QUALIFIERS 



/APPLICATION 

Specifies that the port being created on your service node functions as an 
applications port. 

/[NOJLOG 

Specifies whether characteristics of the ports on your service node are 
displayed when this command is executed. 



EXAMPLE 

LCP> CREATE PORT LTA27: /APPLICATION /NOLOG 

This command creates a port LTA27: to be used as an applications port on 
your service node. The /NOLOG qualifier in this command specifies that 
the characteristics for the applications port on your service node are not 
displayed. 



8-2 



CREATE SERVICE 



CREATE SERVICE 



Creates a service on your service node. 



FORMAT 

service-name 



CREATE SERVICE 



Command Qualifiers Defaults 

/IDENTIFICA TIOtH' id-string" SYS$ANNOUNCE 

/[NOjLOG /LOG 

/[NO]STA TIC-RA TING=rating /NOSTA TIC^RA TING 



P£3TRICTI0NS Yo" cannot create more than one service with the default service name. 



PARAMETERS 



service-name 

Specifies a LAT service name of 1 to 16 ASCII characters. Eligible characters 
are described in Appendix A. If you do not specify a service name in the 
command line, the default service name is the translation of the SYS$NODE 
logical name. 

Coordinate the service names throughout the network to avoid duplicating 
them unintentionally. 



DESCRIPTION 



This command creates a service offered by your service node. You can 
assign up to eight service names on your service node. You can later modify 
the service characteristics with the SET SERVICE command. The service is 
announced in the multicast messages sent by your service node. 

Several service nodes can share one service name. A shared service name 
is especially useful in VAXclusters. It allows the cluster to be known by a 
cluster name and also by individual node names. 



COMMAND 
QUALIFIERS 



/IDENTIFICATION="identification-string" 

Specifies a description for the service. The string is advertised to servers 
in the multicast messages sent by your service node. The string can have 
up to 64 ASCII characters, which cannot begin with an ampersand ( & ). 
Nonprintable characters are translated as spaces. Enclose the string in 
quotation marks (""). The default for this announcement is the translation 
of the SYS$ANNOUNCE logical name. 

/[NOJLOG 

Specifies whether the characteristics for your service node are displayed with 
this command. 

/[NO]STATIC-RATING=rating 

Disables dynamic rating and specifies a static rating when you omit NO. 
Disables static rating and starts dynamic rating when you include NO. 
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CREATE SERVICE 



EXAMPLE 

LCP> CREATE SERVICE SALES /STATIC_RATING=195 /NOLOG 



The command in this example creates the service "SALES" on your service 
node and assigns a static rating of 195. The /NOLOG qualifier in this 
command specifies that the characteristics for your service node are not 
displayed. 
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DELETE PORT 

Deletes an applications port from your service node. 

FORMAT DELETE PORT 

port-name 



Command Qualifiers Defaults 

None None 



RESTRICTIONS The port was created previously with the LATCP CREATE PORT command. 



PARAMETERS port-name 

Specifies the name of the applications port you want to delete. 



DESCRIPTION The DELETE PORT command stops any active session on the applications 

port and then deletes this port from your service node. 



EXAMPLE 

LCP> DELETE PORT LTA27: 

The command in this example deletes the applications port LTA27:. The port 
was created previously with the CREATE PORT command. 
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DELETE SERVICE 



Deletes a service from your service node. 



FORMAT 

service-name 



DELETE SERVICE 



Command Qualifiers 

/[NOJLOG 



Defaults 

/LOG 



RESTRICTIONS None. 



PARAMETERS 



service-name 

Specifies the name of the service, created previously with CREATE SERVICE, 
to be deleted. To find service names, use the SHOW CHARACTERISTICS 
command. The default is the translation of the SYS$NODE logical name. 



DESCRIPTION 



The DELETE SERVICE command removes the service from your service node. 
The service is no longer available to server users and is no longer sent in the 
multicast messages sent by your service node. 



COMMAND 
QUALIFIERS 



/[IMOJLOG 

Specifies whether the characteristics for your service node are displayed when 
this command is executed. 



EXAMPLE 

LCP> DELETE SERVICE SALES 



The command in this example removes the service SALES from your service 
node. The service is no longer available to server users. 
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EXIT 



Stops execution of LATCP and returns you to the DCL command 
level. 



FORMAT EXIT 



Command Qualifiers Defaults 

None None 



RESTRICTIONS None. 



PARAMETERS None. 



DESCRIPTION The EXIT command enab les you to exit from LATCP and returns you to DCL 

command level Pressing |ctrl/z| has the same effect as the EXIT command. 



EXAMPLES 

□ LCP> EXIT 
2 LCP> CTRL/Z 



Each of these commands ends the LATCP session and returns control to the 
DCL command level. 
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HELP 



Lists and explains the LATCP commands. 



FORMAT HELP 

command-name 



Command Qualifiers 

None 



Defaults 

None 



RESTRICTIONS None. 



PARAMETERS 



command-name 

The name of a LATCP command. 



DESCRIPTION 



HELP is an on-line reference for LATCP commands. If you do not specify 
a command name, HELP displays general information on the commands 
for which help is available. Supplying a command name obtains syntax 
information on that command. After you get an initial HELP display and 
then press [Hi] , the HELP stops and your LATCP prompt appears. 



EXAMPLE 

LCP> HELP SET PORT 



In this example, the HELP SET PORT command produces a description of the 
SET PORT command and shows the command format. 
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SET COUNTERS 



Resets your service node counters to zero. 



FORMAT 



SET COUNTERS/ZERO 



Command Qualifiers 

/ZERO 



Defaults 

/ZERO 



RESTRICTIONS ^ou cannot use this command to set device counters or server counters to 

zero. 



PARAMETERS None. 



DESCRIPTION 



The SET COUNTERS/ZERO command allows you to test the performance 
of your service node over a period of time. Once the counters for your LAT 
service node are set to zero, you can observe information that accumulates 
over the specific period by using the LATCP SHOW COUNTERS/NODE 
command, 



COMMAND /ZERO 

Qy/^[_|p|EP3 Specifies to reset the service node counters to zero. 



EXAMPLE 

LCP> SET COUNTERS/ZERO 



The command in this example resets your service node counters to zero. 
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SET NODE 



Allows you to specify LAT node characteristics. 



FORMAT 

node-name 



SET NODE 



Command Qualifiers 

/DISABLE=group-list 

/ENABLB=group-list 

/IDENTIFICA TION=" id-string" 

/[NOJLOG 

/MUL TICAST^ TIMER=seconds 



Defaults 

None 

/ENABLE=(0) 

SYS$ANNOUNCE 

/LOG 

/MUL J\CAST-TMER=60 



RESTRICTIONS ^one. 



PARAMETERS 



node-name 

specifies the name you assign to your service node. The node name can be 
from 1 to 16 ASCII characters in length. Eligible characters are described in 
Appendix A. 

The node name should be the same as the DECnet node name. The DECnet 
node name must be unique within the same logical Ethernet as well as within 
the entire DECnet network. On DECnet nodes, the LAT node name is given 
the DECnet node name, SYS$NODE, by default. If the service node is not 
running DECnet but will be in the future, it is recommended that you define 
SYS$NODE. 

The default is the translation of the SYS$NODE logical name. 



DESCRIPTION 



The SET NODE command allows you to specify: 

• Node name 

• Node identification 

• Groups 

• Timing of configuration messages 

See Chapter 5 for a discussion of these node characteristics. Any 
characteristics that you omit are not changed from their previous settings. 

Because LATCP commands change characteristics dynamically, you can use 
SET NODE prior to activating the LAT port driver or at any time when the 
LAT port driver is active. 
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COMMAND 
QUALIFIERS 



/DISABLE=group-list 

Removes previously enabled groups associated with your service node. 

/ENABLE=group-list 

Gives your service node access to the listed groups. There are 256 groups, 
numbered from through 255. When you enter a group list, use commas (,) 
to separate individual groups. 

Group is enabled by default for all service nodes and servers. For additional 
information about group 0, see your server Management Guide. 

Note: Not all servers support 256 groups. 

/I DENTiFICATION^' identification-String" 

specifies a description for your service node. The string is advertised to 
servers in the multicast messages sent by your service node. The string 
can have up to 64 ASCII characters and cannot begin with an ampersand 
(&). Nonprintable characters are translated as spaces. Enclose the string in 
quotation marks (""). 

/[NOJLOG 

Specifies whether your service node characteristics are displayed when this 
command is executed. /NOLOG prevents the display. 

/MULTICAST-TIMER=seconds 

Specifies the time, in seconds, between the multicast messages sent by 
your service node. The minimum value is 10 seconds; the maximum is 255 
seconds. The default value is 60. 



EXAMPLES 

□ LCP> SET NODE DUKE /IDENT="SALES VAXCLUSTER" /NOLOG 

The command in this example specifies that the announcement "SALES 
VAXCLUSTER" be included in the multicast messages sent from node DUKE. 
The /NOLOG qualifier in this command specifies that the characteristics of 
your service node are not displayed. 

B LCP> SET NODE DUKE /MULTICAST_TIMER=50 /ENABLE=(1 .2) 

The command in this example causes the node DUKE to send multicast 
messages every 50 seconds. This command also enables groups 1 and 2 for 
NODE DUKE. 

B LCP> SET NODE DUKE /DISABLE=2 

The command in this example disables group 2 for node DUKE. Group 2 was 
• enabled previously for the service node. 
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SET PORT 



Logically associates (maps) an applications port with a remote port 
on a server. 



FORMAT 

port-name 



SET PORT 



Command Qualifiers 

/APPLICATION 

/[NOJLOG 

/NODE=remote-node-name 

/PORT=remote-port-name 

/[NO]QUEUED 



/SERVICE=remote-service-name None 



Defaults 

/APPLICATION 

/LOG 

None 

None 

/QUEUED 



RESTRICTIONS You must get the remote node (server) name, remote port name, and remote 

service names from the server manager. 



PARAMETERS port-name 

Specifies the name of the applications port. The applications port name must 
be in the form LTAn:, where « is a unique number from 1 through 9999. 



DESCRIPTION 



The SET PORT command maps an applications port on your service node to 
a port on a server. The applications port must have been created previously 
with the CREATE PORT command. 

You must specify the applications port name and the remote node (server) 
name, plus one or both of the following: 

• Server port name 

• Remote service name 



Note: If you want to connect to a specific port for a service, specify the remote 
service name and the port name. 

The service name on the server is associated with one or more specific ports 
on that server. 



COMMAND 
QUALIFIERS 



/APPLICATION 

Specifies that the port on your service node functions as an applications port. 

/[NOJLOG 

Specifies whether or not to display the characteristics of the ports on your 
service node when this command is executed. 
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/NODE=remote-node-name 

Specifies the name of the remote node (server) to be logically associated with 
the applications port on your service node. 

/PORT=remote-port-name 

Specifies the name of the remote port on a server associated (mapped) with 
the applications port. 

/[NOJQUEUED 

Specifies the type of access being requested for the remote port. 

There are two t5^es of access requests to a port: queued and nonqueued. The 
LAT server manager defines the type of access allowed. 

If you do not want your remote requests to be queued on the server, specify 
/NOQUEUED. A queued or nonqueued request is accepted by the server if 
the remote port is free. If the remote port is busy and queuing is enabled on 
the server, then a remote request is queued. Do not specify /NOQUEUE if 
the port is connected to a remote printer that is accessed by LATSYM. 

/SERVICE=remote-service-name 

Specifies the name of the remote service offered at the server port associated 
with the applications port. 



EXAMPLES 

□ LCP> SET PORT LTA322: /N0DE=LAT1 /P0RT=P0RT_5 

This example specifies that the applications port LTA322: is associated with 
the port named PORT_5 on the server named LATl. 

B LCP> SET PORT LTA322: /NDDE=LAT1 /SERVICE=PRINTER /QUEUED 

This command associates the applications port LTA322: with the service 
PRINTER on server LATl. The service PRINTER can be associated with one 
or more ports on LATl. The /QUEUED qualifier specifies that the server, 
offering the service PRINTER, queue the remote connection request. 
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SET SERVICE 



Allows you to dynamically change service characteristics. 



FORMAT 

service-name 



SET SERVICE 



Command Qualifiers 

/IDENTIFICA TIOl\H' id-string" 

/[NOJLOG 

/[NOJSTA TIC-RA TINQ^static-rating 



Defaults 

SYS$ANNOUNCE 

/LOG 

/NOSTATIC-RATING 



RESTRICTIONS 



You can only specify the service name of a service you created previously 
with the CREATE SERVICE command. 

Your service node characteristics in the LTL0AD.COM file become 
operational upon system startup. The characteristics defined with the SET 
SERVICE command do not stay in effect after a restart of your system. 



PARAMETERS 



service-name 

Specifies the name of the service whose characteristics that you change with 
this command. 

The default service name is the translation of the SYS$NODE logical name. 



DESCRIPTION 



The SET SERVICE command dynamically changes the characteristics of a 
service that you created previously with the CREATE SERVICE command. 



COMMAND 
QUALIFIERS 



/IDENTIFICATiON="identification-string" 

Specifies a new description of the service. The string is announced to server 
users in the multicast messages sent by your service node. The string can 
have up to 64 ASCII characters and cannot begin with an ampersand 
( & ). Nonprintable characters are translated as spaces. Enclose the string 
in quotation marks (""). 

/[NOJLOG 

Specifies whether or not to display the qualifier values used in this command 
when this command is executed. /NOLOG prevents the display. 

/[l\IO]STATIC-RATII\IG=rating 

Disables dynamic rating and specifies a static rating when you omit NO. 
Disables static rating and starts dynamic rating when you include NO. 
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EXAMPLE 

LCP> SET SERVICE SALES /IDENT="A MEMBER OF THE SALES CLUSTER" 



The command in this example specifies a new announcement "A MEMBER 
OF THE SALES CLUSTER" for the service SALES. This string is announced 
with the service SALES in the multicast messages sent by your service node. 
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SHOW CHARACTERISTICS 

Displays the characteristics for your service node. 

FORMAT SHOW CHARACTERISTICS 

Command Qualifiers Defaults 

None None 

RESTRICTIONS None. 
PARAMETERS None. 



DESCRIPTION This command displays the node and service parameters for your LAT service 

node. 

• QuaUfier settings for the SET NODE command 

• LAT protocol status 

• LAT protocol version 

• Service characteristics defined for your service node 

EXAMPLE 

LCP> SHOW CHARACTERISTICS 
LCP Characteristics 

Node name = \DUKE\ 

Node name = \DUKE\ Node Identification = \A MEMBER OF THE SALES CLUSTER\ 

Groups = (0.64,127) 

Multicast timer = 60 seconds 

LAT Version =5.1 LAT Protocol is active 

Service Names and Ids : 

Service name : \SALES\ rating : auto 

id : \SALES SERVICEN 
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SHOW COUNTERS 



Displays counter information for your LAT service node. 



FORMAT 



SHOW COUNTERS 



Command Qualifiers 

/DEVICE 

/NODE 

/SERVERS 



Defaults 

/NODE 
/NODE 
/NODE 



RESTRICTIONS None. 



PARAMETERS None. 



DESCRIPTION This command displays counter information tabulated by the LAT port driver. 



COMMAND 
QUALIFIERS 



The default for the qualifiers is the /NODE qualifier. 

/DEVICE 

Specifies to display the Ethernet device counters. This information is the sum 
of all Ethernet usage on your node, including LAT and DECnet. 

For additional information on device counters, see the Network Control 
Program (NCP) in the VAX/VMS documentation. 

/NODE 

Specifies to display LAT counters for your service node (does not include 
DECnet counters). Table 8-1 gives descriptions of the LAT counters. 

Table 8—1 Descriptions of LAT Node Counters 



Counter 



Receive frames 
Receive errors 

Receive duplicates 

Transmit frames 



Meaning 



The number of LAT messages successfully 
received by the node. 

The number of received messages 
with detected problems. The Ethernet 
controller flagged these messages. 

The number of duplicated received 
messages; this can indicate a system 
slowdown. 

The number of LAT messages successfully 
transmitted by the node. 
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Table 8-1 (Cont.) Descriptions of LAT Node Counters 



Counter 



Meaning 



Transmit errors 



Last transmit failure code 



Retransmissions 



Circuit timeouts 



Protocol errors 



Protocol bit mask 



The number of transmitted messages 
with detected problems. The Ethernet 
controller flagged these messages. 

A hexadecimal number that indicates the 
reason for the last transmit failure. If a 
failure code exists, the failure reasons are 
shown at the end of the counters display. 

The number of LAT messages that the 
node retransmitted because they were not 
acknowledged by the server. 

The number of times a circuit to a server 
timed out, indicating that a server failed to 
send a valid message in the required time 
span. 

The number of LAT messages with an 
illegal format received by the node. The 
actual error identification is recorded in the 
protocol error bit mask. 

A hexadecimal number that indicates 
circuit message errors or slot errors. If 
you convert this number to binary format, 
you can find protocol error bit mask 
definitions listed in Table 8-2 



Resource errors 



No transmit buffer 



Unit timeouts 



Solicitation failures 



Discarded output bytes 



The number of times the service node 
attempted to create a circuit with a new 
server but failed because of insufficient 
resources. 

The number of times no buffer was 
available for transmission. 

A repeat of a deallocation of resources. 
This occurs when an attempt is made to 
deallocate a Unit Control Block (UCB) that 
was already deallocated. This happens 
when there is an attempt to stop a LAT 
circuit on the service node. 

The number of times a request for a 
connection to a remote device failed. 

The number of data bytes which were 
discarded because of an overflow of an 
internal buffer before the data could be 
output to an LT device. 



Table 8-2 lists the protocol error bit mask definitions. 
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Table 8-2 Protocol Error Bit Mask Definitions 

Bit Meaning 

Invalid start message received 

1 Zero node Index received 

2 Node circuit index out of range 

3 Node circuit sequence invalid 

4 Node circuit index no longer valid 

5 Circuit was forced to halt 

6 Invalid server slot index 

7 Invalid node slot index 

8 Invalid credit field or too many credits used 

9 Repeat create of slot by server 

10 Invalid sequence number received In start message 

1 1 Repeat disconnect of slot by server 



/SERVERS 

Specifies to display LAT counters for all servers known to your service node. 

Note that some servers may be listed twice in the SHOW SERVER display. 
LATCP keeps up to two sets of counters for servers which had an abnormal 
circuit termination. This allows the server information to be retained and 
examined by a service specialist. 



EXAMPLES 



The foUovdng is an example of a display generated by the SHOW 
COUNTERS /NODE command: 



D LCP>SHOW COUNTERS /NODE 
LCP Node Counters 

127597 Receive frames 

Receive errors 

3 Receive duplicates 

161885 Transmit frames 

Transmit errors 

00000000 Last transmit failure code 

28 Retransmissions 

6 Circuit timeouts 

Protocol errors 

00000000 Protocol bit mask 

Resource errors 

No transmit buffer 

Unit timeouts 

Solicitation failures 

Discarded output bytes 
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The following is an example of a display generated by the SHOW 
COUNTERS /SERVER command: 



2 LCP>SHOW COUNTERS /SERVERS 
LCP Server Counters for LATl 



7882 


Receive frames 


8743 


Transmit frames 





Retransmissions 





Out of sequence frames 





Invalid messages 





Invalid slots 
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SHOW PORTS 



Displays the characteristics for the ports on your service node. 



FORMAT 

port-name 



SHOW PORTS 



Command Qualifiers 

/APPLICATION 
/INTERACTIVE 



Defaults 

/APPLICATION 
None 



RESTRICTIONS Do not use the /APPLICATION or /INTERACTIVE qualifiers with a specific 

port name. 



PARAMETERS 



port-name 

Specifies the name of the port for which information is displayed. When 
you issue the SHOW PORTS command without entering a port name, 
characteristics for all of the LTAn: ports on the service node are displayed. 



DESCRIPTION 



If the port is an applications port, the display lists the remote node name and 
remote port and/or remote service name that you specified in the SET PORT 
command. If the port is an interactive port, it is currently being used by a 
server user. For all ports with current connections, the server sends the node 
name and port name to your service node. These are listed in the display. 



COMMAND 
QUALIFIERS 



/APPLICATION 

Generates a display for all applications ports. 

/INTERACTIVE 

Generates a display for all interactive ports. 



EXAMPLE 




LCP> SHOW PORTS 




Local Port Name = LTA62: 


<interactive> 


Actual Remote Node Name 


= LATIO 


Actual Remote Port Name 


= P0RT_7 



Local Port Name = LTA322: <applicatioii> 
Specified Remote Node Name = LATl 
Specified Remote Port Name = LQP02 
Actual Remote Node Name = LATl 
Actual Remote Port Name = LQP02 
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Local Port Name = LTA321: <application> 

Specified Remote Node Name = LATl 
Specified Remote Service Name = PRINTER 



The first port displayed in this example is the interactive port LTA62: 
connected to Port_7 on the LATIO server. 

The second port displayed in this example is the LTA322: applications 
port. Note that in this display the presence of the actual values indicates an 
established connection. 

The third port displayed in this example is the LTA321: applications port 
mapped to the PRINTER service on the LATl server. 
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SHOW SERVERS 



Displays the characteristics for the servers known to your service 
node. 



FORMAT 



SHOW SERVERS 



RESTRICTIONS None. 



PARAMETERS None. 



DESCRIPTION 



Displays the following information about servers known to your service node: 

• Ethernet address 

• Server status 

• Number of active users 



EXAMPLE 



LCP>SHOW SERVERS 

LCP Server Characteristics for LATl 

Ethernet address = AA-OO-03-Ol-OD-BC 

Server is active Active users 
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START NODE 



Starts the LAT port driver and sets service node characteristics. 



FORMAT 

node-name 



START NODE 



Command Qualifiers 

/DISABLE=group-list 
/ENABLE=group-list 
/IDENTIFICA TION=^' id-string" 
/[NOJLOG 



Defaults 

None 

/ENABLE=(0) 
SYS$ANNOUNCE 
/LOG 



/MUL TIC A ST_ TIMER=seconds /MUL TIC AST-. TIMEFhSO 



RESTRICTIONS None. 



PARAMETERS 



node-name 

Specifies the name you choose for your service node. The node name can 
be from 1 to 16 ASCII characters long. Eligible characters are described in 
Appendix A. The default is the translation of the SYS$NODE logical name. 



DESCRIPTION 



The START NODE command activates the LAT port driver. Before issuing 
this command, however, you must invoke the System Generation Utility 
(SYSGEN) to load the LAT port driver and the first LT: template unit control 
block (UCB) as follows: 

$ RUN SYS$SYSTEM: SYSGEN 

SYSGEN> CONNECT LTAO: /NGADAPTER 

Note that use of the SYSGEN CONNECT command requires the CMKRNL 
privilege. 

After the LAT port driver is activated, you can dynamically modify your node 
characteristics with SET NODE. Also, if DECnet is to be started on your node, 
start DECnet before starting the LAT port driver. 

When you start LAT on your node, LATCP attempts to find an Ethernet 
controller device on the node. If the controller on your node does not match 
a controller that LAT recognizes, LAT attempts to translate the logical name, 
LAT$DEV1CE, as the controller name. Use the following command to define 
an Ethernet controller device before starting LAT: 

$ DEFINE/SYSTEM/EXEC LAT$DEVICE dev-name: 

The STOP NODE command clears the current node characteristics. Invoke 
the LTLOAD.COM file to start LAT, or set the node characteristics manually 
before starting LAT. 
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COMMAND 
QUALIFIERS 



/DISABLE=group-list 

Removes previously enabled groups associated with your service node. 

/EI\IABLE=group-list 

Gives your service node access to the listed groups. There are 256 groups, 
numbered from through 255. When you enter a group list, use commas (, ) 
to separate individual groups. The default is that no groups are enabled. 

Note: Not all servers support 256 groups. 

/IDENTIFICATION- identification-String" 

Specifies a description for your service node. The string is advertised to 
servers in the multicast messages sent by your service node. The string 
can have up to 64 ASCII characters and cannot begin with an ampersand 
( & ). Nonprintable characters are translated as spaces. Enclose the string in 
quotation marks (""). 

/[NOJLOG 

Specifies whether to display your service node characteristics when this 
command is executed. /NOLOG prevents the display. 

/MUL TIC AST- TIMER=seconds 

Specifies the time, in seconds, between the multicast messages sent by 
your service node. The minimum value is 10 seconds; the maximum is 255 
seconds. The default value is 60. 



EXAMPLE 



LCP> START NODE DUKE /ID 



The command in this example starts node DUKE and assigns default values 
for the command qualifiers. 
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STOP NODE 



Shuts down the LAT port driver and terminates all of the sessions 
on LTAn: ports. 



FORMAT 



STOP NODE 



Command Qualifiers 

None 



Defaults 

None 



RESTRICTIONS None. 



PARAMETERS None. 



DESCRIPTION 



Use the following recommended steps to stop the LAT port driver with STOP 
NODE: 

1 Since active connections are disconnected without warning, use the DCL 
REPLY command to issue warnings to LAT users to log off the node's 
services, before you issue the STOP command. 

If the node is down for a long period, tell the user when the node will be 
back up. 

2 In response to the LCP> prompt, issue the LATCP command SET NODE 
node-name /lDENTlFlCAnON=" identification-string". In the identification 
string, announce the reason for the shutdown to the LAT server. 

3 Issue the LATCP STOP NODE command. 

If you want to stop the LAT port driver and want your service node to have 
the same characteristics when you restart the driver, do not use the START 
NODE command. Instead, invoke the SYS$MANAGER:LTLOAD.COM 
command procedure. Alternatively, after stopping the LAT port driver using 
STOP NODE, you can set up your node characteristics manually with the 
SET NODE and SET SERVICE commands. 



EXAMPLE 



$ REPLY /ALL "LAT SERVICE SHUTTING DOWN IN 5 MINUTES. PLEASE LOG OFF" 



This command notifies users not connected through a server that the node is 
temporarily shutting down. 



LCP> SET NODE DUKE /IDENT="SHUT DOWN FOR SERVICE--BACK UP 2:00 PM.' 



This command notifies users connected through a server that the services 
offered by node DUKE are temporarily unavailable. 
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LCP> STOP NODE 



This command shuts down the LAT port driver and disconnects all sessions 
to your node. 
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A ASCII Characters for Node and Service 
Names 



These are the ASCII characters used to specify node and service names for 
your service node: 

"$"_dollar sign, ASCII code 36 

"."—hyphen, ASCII code 45 

"." or "-"— period or dash, ASCII code 46 

"0 through 9"— numerals, ASCII codes 48-57 

"A through Z" — uppercase letters, ASCII codes 65-90 

"_"— underscore, ASCII code 95 

"a through z"— lowercase letters, ASCII codes 97-122 

Part of the international character set — ASCII codes 192-253 

Care must be taken to coordinate the service names throughout the network 
to avoid duplicating service names unintentionally. 

Names can be from 1 through 16 characters in length. Note that spaces are 
invalid. 
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This appendix describes the terminal and queue characteristics required for 
setting up printers on VMS systems. The appendix contains two tables: 

• Table B-1 shows the formats of standardized SET TERMINAL and 
INITIALIZE/QUEUE commands. These formats illustrate qualifiers that 
are required for all printers. 

• Table B-2 lists particular printers and indicates any associated values that 
usually should be specified for a given command qualifier. 

In addition, the appendix includes comments about a few of these 
qualifiers. For further details about the qualifiers for SET TERMINAL and 
INITIALIZE/QUEUE see Chapter 6 in this guide and the VAX/VMS DCL 
Dictionary. 

Table B-2 shows the standardized formats of the SET TERMINAL and 
INITIALIZE/QUEUE commands. The qualifiers in these two commands 
specify terminal or queue characteristics that you must set for all printers on 
your VMS system. Variables are in lowercase italics. 

Table B-1 Command Qualifiers Required for Remote Printers 



Command Qualifier 



SET TERMINAL LTAnn: /PERMANENT 

/NOBROADCAST 
/DEVICE=ti/;je 
/\NlDTH=value 
/PAGE^alue 

INITIALIZE/QUEUE /START 

/PROCESSOR=LATSYM 

/FORM=form 

/RETAIN=ERROR 

/DEFAULT=OflIues 

/RECORD_BLOCKING 

/OU=LT Ann-.queue— name 



The following list includes comments on some of the qualifiers shown in 
Table B-2: 

SET TERMINAL Comments: 

/DEVICE This qualifier specifies a page width and page length that 

is appropriate for the device specified in a SET TERMINAL 
command. However, for some devices you may want to select 
alternative values. For example, the qualifier /DEVICE=LA210 will 
set the /WIDTH value to 132 and the /PAGE value to 66. When 
you use narrow paper in the LA210 device, you can override the 
default width value with a /WIDTH=80 qualifier, and the printer 
will be correct for the paper used. 
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INITIALIZE/QUEUE Comments: 

/DEFAULT This qualifier, unless otherwise specified in the list, specifies any 

valid defaults the user wishes for the printer. 

/FORM This qualifier usually specifies a user-defined form having the 

appropriate /PAGE and /WIDTH values to match the printer and 
terminal characteristics. 

Different types of printers vary in the values necessary for terminal and queue 
characteristics. Table B-2 shows values that must be specified for qualifiers 
that define nondefault characteristics. Entries listed as "User Preference" 
means that you can use any valid /DEVICE, /WIDTH, and /PAGE values 
with the SET TERMINAL command or any valid /DEFAULT and /FORM 
values with the INITIALIZE/QUEUE command. 

Table B-2 Additional Qualifiers Required for Particular Devices 



Device 



SET TERMINAL 
Command 



INITIALIZE/QUEUE Command 



LA 12, LA34 
LA36, LA38 
LA50, LA 100 
LQP02, LQP03 
LN01S, LN03S 

LA 120, LA210 

LXY12-DA 
LXY22-DA 



LCP01 



User Preference 



User Preference 



LG01,LG02 



LVP16 Plotter 

DECtalk 
DTC01, DTC03 



/NOTAB 

/FORM 

/WIDTH=134 

/PAGE=66 

/NOWRAP 

/NOEIGHTBIT 

/INTERACTIVE 

/FULLDUP 

/TAB 

/FORM 

/SCOPE 

/LOWERCASE 

/EIGHTBIT 

/TTSYNC 

/NOMODEM 

/NOECHO 

/NOWRAP 

/NOESCAPE 

/FORM 
/WIDTH=134 
/PAGE=66 
/NOWRAP 

/WIDTH=132 
/PAGE=0 

/WIDTH=132 
/PAGEK) 



User Preference 

User Preference 

(NOTE: Do NOT spool these devices.) 



/DEFAULT" (NOFLACNOFEED, 

NOTRAILER,NOBURST) 



/SCHEDULE" NOSIZE 



/DEFAULT=NOFEED 



/DEFAULT" (NOFLAG.NOFEED, 

NOTRAILER,NOBURST) 

/DEFAULT" (NOFLAG,NOFEED, 

NOTRAILER,NOBURST) 
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This appendix lists the LATCP error messages and gives an explanation of 
each one. 

%LATCP-E-CANT BIND. Can't Initialize device. 

Explanation: Issued when the LAT device cannot be initialized. 

y,LATCP-E-INTERNAL. LATCP internal error 

Explanation: Issued when LATCP or LAT port driver has insufficient buffer 
space or another problem. 

XLATCP-E-IVCMD. Invalid command 

Explanation: Issued when LATCP reports a general command syntax error. 

XLATCP-E-IVDEV, Invalid node or device name 

Explanation: Issued when an invalid LT device or node name is specified on 
CREATE or SHOW commands, or when an invalid or nonexistent LT device 
name is specified on a SET command. 

7,LATCP-E-IVQUAL. Value for qualifier "XXX" is invalid as "VW" 

Explanation: Issued when the value VW for the parameter XXX of a SET 
command is invalid or out of range. 

y.LATCP-E-LOCKED. Data base locked. Try again later. 

Explanation: Issued when LATCP cannot run because another user is 
modifying the LATCP database. 

%LATCP-E-MAXSERV , Maximum number of services exceeded 

Explanation: Issued on a CREATE SERVICE command when eight other 
services already exist. 

XLATCP-E-NONODE, Node name has not been initialized 

Explanation: Issued when an attempt was made to start the LAT port driver 
without a proper LAT node name set up. 

%LATCP-E-NOPORTS. No such port(s) 

Explanation: Issued when a nonexistent port is specified on a SHOW 
command. 

y.LATCP-E-NOSUCHSERV, Service name does not exist 

Explanation: Issued when you attempt to use the SET command to modify a 
service not previously set up with a CREATE command. 

XLATCP-E-NOTFROMLAT. Unable to shut dovm LAT from a LAT terminal 

Explanation: Issued when you enter a LATCP STOP NODE command from 
a LAT terminal. 

y,LATCP-E-NOTINITED , LAT terminal port driver controller init not 
called 
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Explanation: Issued when the LAT port driver cannot start because you did 
not properly initialize it. 

7.LATCP-E-N0TL0ADED, LAT terminal port driver (LTDRIVER) is not loaded 

Explanation: Issued when you attempt to start the LAT port driver before 
loading the driver using the SYSGEN CONNECT command. 

'/.LATCP-E-NOTSTARTED. LAT terminal port driver not started 

Explanation: Issued whenever an attempt to start the LAT port driver is 
unsuccessful. 

y.LATCP-E-NOTSTOPPED, LAT terminal port driver not stopped 

Explanation: Issued whenever a STOP NODE command fails to stop the 
LAT protocol. 

y,LATCP-I-NOSERVERS, No known servers 

Explanation: Issued when you issue a SHOW COUNTERS/SERVER or 
SHOW SERVERS command, but there are not any servers in the LATCP 
database. 

%LATCP-E-SERVEXISTS, Service name already exists 

Explanation: Issued when you attempt to CREATE a service already created 
for this node. 

XLATCP- I -STARTED. LAT terminal port driver started 

Explanation: Issued when the LAT port driver is started successfully. 

XLATCP-I-STOPPED. LAT terminal port driver stopped 

Explanation: Issued when the LAT port driver is stopped successfully. 
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Alternate root 

creating on common system disk* 1-30 
ANALYZE/ERROR_LOG 

TA79 device support "3-6 
Application program 
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connecting to LAT applications ports* 7-1 

hangup notification* 7-3 

QIO interface for * 7-2 
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examples* 5- 10 

EXIT* 8-7 
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SHOW CHARACTERISTICS* 8- 16 
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space requirement* 1-25 
DECtalk DTK$ facility* 3- 12 
Default file 
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